detectImportOptions

ファイルの内容に基づくインポートオプションの作成

構文

opts = detectImportOptions(filename)

opts = detectImportOptions(filename,Name,Value)

説明

opts = detectImportOptions(filename) は、ファイル内のテーブルを検索し、そのインポートオプションを返します。オプションオブジェクトを変更し、それを readtable とともに使用して、MATLAB^® がテーブルデータをインポートする方法を制御できます。返されるオプションのタイプは、ファイル拡張子によって決まります。たとえば、filename がスプレッドシートファイルの場合、関数は SpreadsheetImportOptions オブジェクトを返します。ただし、filename がテキストファイルの場合、関数は DelimitedTextImportOptions オブジェクトまたは FixedWidthImportOptions オブジェクトを返し、filename が XML ファイルの場合、XMLImportOptions オブジェクトを返します。

例

opts = detectImportOptions(filename,Name,Value) は、1 つ以上の Name,Value ペアの引数によって指定された追加パラメーターを使用して、ファイル内のテーブルを検索します。

例

すべて折りたたむ

スプレッドシートファイルのインポートオプションの検出と使用

ライブスクリプトを開く

スプレッドシートファイルのインポートオプションを検出し、インポートする変数を指定してから、データを読み取ります。

ファイルからインポートオプションオブジェクトを作成します。

opts = detectImportOptions('patients.xls')

opts = 
  SpreadsheetImportOptions with properties:

   Sheet Properties:
                        Sheet: ''

   Replacement Properties:
                  MissingRule: 'fill'
              ImportErrorRule: 'fill'

   Variable Import Properties: Set types by name using setvartype
                VariableNames: {'LastName', 'Gender', 'Age' ... and 7 more}
                VariableTypes: {'char', 'char', 'double' ... and 7 more}
        SelectedVariableNames: {'LastName', 'Gender', 'Age' ... and 7 more}
              VariableOptions: Show all 10 VariableOptions 
	Access VariableOptions sub-properties using setvaropts/getvaropts
           VariableNamingRule: 'modify'

   Range Properties:
                    DataRange: 'A2' (Start Cell)
           VariableNamesRange: 'A1'
                RowNamesRange: ''
           VariableUnitsRange: ''
    VariableDescriptionsRange: '' 
	To display a preview of the table, use preview

オプションオブジェクトを変更してインポートする変数を指定します。

opts.SelectedVariableNames = {'Systolic','Diastolic'};

readtable をオプションオブジェクトと共に使用して、指定した変数をインポートします。

T = readtable('patients.xls',opts);
summary(T)

Variables:

    Systolic: 100x1 double

        Values:

            Min         109   
            Median      122   
            Max         138   

    Diastolic: 100x1 double

        Values:

            Min           68  
            Median      81.5  
            Max           99

テキストファイルのインポートオプションの検出と使用

ライブスクリプトを開く

インポートオプションを作成し、複数の変数に対しデータ型を適用してから、データを読み取ります。

テキストファイルからインポートオプションオブジェクトを作成します。

opts = detectImportOptions('airlinesmall.csv')

opts = 
  DelimitedTextImportOptions with properties:

   Format Properties:
                    Delimiter: {','}
                   Whitespace: '\b\t '
                   LineEnding: {'\n'  '\r'  '\r\n'}
                 CommentStyle: {}
    ConsecutiveDelimitersRule: 'split'
        LeadingDelimitersRule: 'keep'
       TrailingDelimitersRule: 'ignore'
                EmptyLineRule: 'skip'
                     Encoding: 'ISO-8859-1'

   Replacement Properties:
                  MissingRule: 'fill'
              ImportErrorRule: 'fill'
             ExtraColumnsRule: 'addvars'

   Variable Import Properties: Set types by name using setvartype
                VariableNames: {'Year', 'Month', 'DayofMonth' ... and 26 more}
                VariableTypes: {'double', 'double', 'double' ... and 26 more}
        SelectedVariableNames: {'Year', 'Month', 'DayofMonth' ... and 26 more}
              VariableOptions: Show all 29 VariableOptions 
	Access VariableOptions sub-properties using setvaropts/getvaropts
           VariableNamingRule: 'modify'

   Location Properties:
                    DataLines: [2 Inf]
            VariableNamesLine: 1
               RowNamesColumn: 0
            VariableUnitsLine: 0
     VariableDescriptionsLine: 0 
	To display a preview of the table, use preview

変数 TaxiIn と変数 TaxiOut の Type プロパティを確認します。

getvaropts(opts,{'TaxiIn','TaxiOut'})

ans = 
  1x2 TextVariableImportOptions array with properties:

    Name
    Type
    FillValue
    TreatAsMissing
    QuoteRule
    Prefixes
    Suffixes
    EmptyFieldRule
    WhitespaceRule

変数 TaxiIn と TaxiOut の型を double に変更します。

 opts = setvartype(opts,{'TaxiIn','TaxiOut'},'double');

インポートして確認する変数のサブセットを指定します。

opts.SelectedVariableNames = {'TaxiIn','TaxiOut'};

関数 readtable をオプションオブジェクトと共に使用して、選択した変数をインポートします。テーブルの概要を表示します。

T = readtable('airlinesmall.csv',opts);
summary(T)

Variables:

    TaxiIn: 123523x1 double

        Values:

            Min             0      
            Median          5      
            Max             1451   
            NumMissing      37383  

    TaxiOut: 123523x1 double

        Values:

            Min             0      
            Median          13     
            Max             755    
            NumMissing      37364

インポートされるテキストデータのデータ型の指定

ライブスクリプトを開く

インポートオプションを指定して、テキストデータを string データ型としてインポートします。

ファイルのオプションオブジェクトを作成します。

opts = detectImportOptions('outages.csv');

インポートする変数を readtable を使って指定してから、概要を表示します。選択された変数のデータ型は char です。

opts.SelectedVariableNames = {'Region','Cause'};
T = readtable('outages.csv',opts);
summary(T)

Variables:

    Region: 1468x1 cell array of character vectors

    Cause: 1468x1 cell array of character vectors

テキストデータを string データ型としてインポートしてから、名前と値のペア TextType を指定してインポートオプションを作成します。

opts = detectImportOptions('outages.csv','TextType','string');

インポートする変数を readtable を使って指定してから、概要を表示します。ここで、選択された変数のデータ型は string です。

opts.SelectedVariableNames = {'Region','Cause'};
T = readtable('outages.csv',opts);
summary(T)

Variables:

    Region: 1468x1 string

    Cause: 1468x1 string

カスタムの XML 名前空間接頭辞の登録

ライブスクリプトを開く

名前と値の引数 RegisteredNamespaces を使用して、入力ファイルの既存の名前空間 URL にカスタムの XML 名前空間接頭辞を登録します。

XML ファイルから XMLImportOptions オブジェクトを作成します。'VariableSelectors' の値として Street 要素ノードの XPath 式を指定し、接頭辞 myPrefix を Street ノードに属する URL に登録します。

opts = detectImportOptions("students.xml","RegisteredNamespaces", ["myPrefix","https://www.mathworks.com"],...
    "VariableSelectors","//myPrefix:Street")

opts = 
  XMLImportOptions with properties:

   Replacement Properties:
                     MissingRule: "fill"
                 ImportErrorRule: "fill"
                RepeatedNodeRule: "addcol"

   Variable Import Properties: Set types by name using setvartype
                   VariableNames: "Street"
                   VariableTypes: "string"
           SelectedVariableNames: "Street"
                 VariableOptions: Show all 1 VariableOptions 
	Access VariableOptions sub-properties using setvaropts/getvaropts
              VariableNamingRule: "preserve"

   Location Properties:
                   TableSelector: <missing>
                     RowSelector: <missing>
               VariableSelectors: "//myPrefix:Street"
           VariableUnitsSelector: <missing>
    VariableDescriptionsSelector: <missing>
                RowNamesSelector: <missing>
            RegisteredNamespaces: ["myPrefix"    "https://www.mathworks.com"]

関数 readtable をオプションオブジェクトと共に使用して、選択した変数をインポートします。

T2 = readtable("students.xml",opts)

T2=7×1 table
          Street       
    ___________________

    "591 Spring Lane"  
    "4641 Pearl Street"
    "30 Highland Road" 
    "3388 Moore Avenue"
    "3388 Moore Avenue"
    "22 Angie Drive"   
    "65 Decatur Lane"

入力引数

すべて折りたたむ

`filename` — 読み取るファイルの名前
文字ベクトル | string スカラー

読み取るファイルの名前。文字ベクトルまたは string スカラーとして指定します。

ファイルの場所によって、filename は次のいずれかの形式をとります。

場所

形式

現在のフォルダー、または MATLAB パス上のフォルダー

ファイル名を filename で指定します。

例: 'myFile.txt'

フォルダー内のファイル

ファイルが現在のフォルダーまたは MATLAB パス上のフォルダーにない場合は、filename に絶対パス名または相対パス名を指定します。

例: 'C:\myFolder\myFile.xlsx'

例: '\imgDir\myFile.txt'

インターネット URL

ファイルをインターネットの Uniform Resource Locator (URL) として指定する場合、filename には 'http://' または 'https://' のプロトコルタイプが含まれていなければなりません。

例: 'http://hostname/path_to_file/my_data.csv'

リモートの場所

リモートの場所に保存されたファイルの場合、filename は次の形式で指定されたファイルの絶対パスを含まなければなりません。

scheme_name://path_to_file/my_file.ext

リモートの場所に基づいて、scheme_name には次の表の値のいずれかを指定できます。

リモートの場所	`scheme_name`
Amazon S3™	`s3`
Windows Azure^® Blob Storage	`wasb`, `wasbs`
HDFS™	`hdfs`

詳細については、リモートデータの操作を参照してください。

例: 's3://bucketname/path_to_file/my_file.csv'

filename にファイル拡張子が含まれる場合、detectImportOptions は拡張子からファイル形式を判別します。それ以外の場合は、'FileType' の名前と値のペアを指定してファイルの種類を指定しなければなりません。

関数 detectImportOptions は、.txt、.dat、.csv、.xls、.xlsb、.xlsm、.xlsx、.xltm、.xltx、.ods および .xml の各ファイル拡張子をサポートしています。

メモ

ファイル拡張子 .xlsb と .ods は、Excel^® for Windows^® を備えたプラットフォームでのみサポートされます。

データ型: char | string

名前と値のペアの引数

オプションの Name,Value の引数ペアをコンマ区切りで指定します。Name は引数名で、Value は対応する値です。Name は引用符で囲まなければなりません。Name1,Value1,...,NameN,ValueN のように、複数の名前と値のペアの引数を任意の順序で指定できます。

例: 'FileType','spreadsheet'

サポートされるすべてのファイルの種類

すべて折りたたむ

`FileType` — ファイルの種類
`'spreadsheet'` | `'text'` | `'delimitedtext'` | `'fixedwidth'` | `'xml'`

ファイルの種類。'FileType' と次の値のいずれかで構成されるコンマ区切りのペアとして指定します。

値	ファイルのインポートオプション
`'spreadsheet'`	`SpreadsheetImportOptions` オブジェクトを返します。
`'text'`	テキストファイルのレイアウトにより、`DelimitedTextImportOptions` オブジェクトまたは `FixedWidthImportOptions` オブジェクトを返します。
`'delimitedtext'`	`DelimitedTextImportOptions` オブジェクトを返します。このオプションは、列が区切り文字で区切られているテキストファイルに使用します。
`'fixedwidth'`	`FixedWidthImportOptions` オブジェクトを返します。このオプションは、固定幅の列をもつテキストファイルに使用します。
`'xml'`	`XMLImportOptions` オブジェクトを返します。このオプションは、XML ファイルに使用します。

filename にファイル拡張子が含まれない場合、または次の拡張子以外の場合は、名前と値のペアの引数 'FileType' を使用します。

テキストファイルの場合、.txt、.dat または .csv
スプレッドシートファイルの場合、.xls、.xlsb、.xlsm、.xlsx、.xltm, .xltx または .ods
XML ファイルの場合、.xml

ファイル拡張子 .xlsb と .ods は、Excel for Windows を備えたプラットフォームでのみサポートされます。

例: 'FileType','text'

データ型: char | string

`TextType` — インポートされるテキストデータの型
`'char'` (既定値) | `'string'`

インポートされるテキストデータの型。'TextType' と 'char' または 'string' で構成されるコンマ区切りのペアとして指定します。

'char' — テキストデータを文字ベクトルとして MATLAB にインポートします。
'string' — テキストデータを string 配列として MATLAB にインポートします。

例: 'TextType','char'

`DatetimeType` — インポートされる日付と時刻のデータの型
`'datetime'` (既定値) | `'text'` | `'exceldatenum'` (スプレッドシートファイルのみ)

インポートされる日付と時刻のデータの型。'DatetimeType' と、'datetime'、'text'、'exceldatenum' のいずれかの値で構成されるコンマ区切りのペアとして指定します。値 'exceldatenum' はスプレッドシートファイルのみに適用され、テキストファイルに対しては有効ではありません。

値インポートされる日付と時刻のデータの型

値	インポートされる日付と時刻のデータの型
`'datetime'`	MATLAB の `datetime` データ型詳細については、`datetime` を参照してください。
`'text'`	`'DatetimeType'` を `'text'` として指定した場合、インポートされる日付と時刻のデータの型は `'TextType'` パラメーターで指定された値によって決まります。 `'TextType'` が `'char'` に設定されている場合、インポート関数は日付を文字ベクトルの cell 配列として返します。 `'TextType'` が `'string'` に設定されている場合、インポート関数は日付を string の配列として返します。
`'exceldatenum'`	Excel のシリアル日付値シリアル日付値は、指定された基準日からの日数に等しい単一の数値です。Excel のシリアル日付値では MATLAB のシリアル日付値とは異なる基準日が使用されています。Excel の日付の詳細については、`https://support.microsoft.com/en-us/kb/214330` を参照してください。

'datetime'

MATLAB の datetime データ型

詳細については、datetime を参照してください。

'text'

'DatetimeType' を 'text' として指定した場合、インポートされる日付と時刻のデータの型は 'TextType' パラメーターで指定された値によって決まります。

'TextType' が 'char' に設定されている場合、インポート関数は日付を文字ベクトルの cell 配列として返します。
'TextType' が 'string' に設定されている場合、インポート関数は日付を string の配列として返します。

'exceldatenum'

Excel のシリアル日付値

シリアル日付値は、指定された基準日からの日数に等しい単一の数値です。Excel のシリアル日付値では MATLAB のシリアル日付値とは異なる基準日が使用されています。Excel の日付の詳細については、https://support.microsoft.com/en-us/kb/214330 を参照してください。

データ型: char | string

`ReadVariableNames` — 最初の行を変数名として読み取る
`true` | `false`

最初の行を変数名として読み取るかどうかを示すインジケーター。'ReadVariableNames' と、true または false で構成されるコンマ区切りのペアとして指定します。指定しない場合、readtable は変数名の有無を自動的に検出します。

インジケーター	説明
`true`	読み取る領域の最初の行にテーブルの変数名が含まれている場合に使用します。`readtable` は、検出した変数名を使用して `T` の各列に変数を作成します。
`false`	読み取る領域の最初の行にテーブルのデータが含まれている場合に使用します。`readtable` は、`'Var1',...,'VarN'` の形式で既定の変数名を作成します。ここで、`N` は変数の数です。
指定なし	指定しない場合、インポート関数は `true` または `false` を自動的に検出し、それに応じて続行します。

データ型: logical

`VariableNamingRule` — 変数名を保持するかどうかのフラグ
`'modify'` (既定値) | `'preserve'`

変数名を保持するかどうかのフラグ。VariableNamingRule と、'modify' または 'preserve' のいずれかで構成されるコンマ区切りのペアとして指定します。

'modify' — 無効な変数名 (関数 isvarname で判定) を、有効な MATLAB 識別子に変換。
'preserve' — スペースや非 ASCII 文字を含む変数名など、有効な MATLAB 識別子ではない変数名を保持。

R2019b 以降、変数名と行名には、スペースや非 ASCII 文字など任意の文字を含めることができます。また、英字だけでなく任意の文字で始めることができます。変数名と行名は、有効な MATLAB 識別子 (関数 isvarname で判定) である必要はありません。これらの変数名と行名を保持するには、VariableNamingRule の値を 'preserve' に設定します。

データ型: char | string

`ReadRowNames` — 最初の列を行名として読み取るかどうかを示すインジケーター
`false` (既定値) | `true`

最初の列を行名として読み取るかどうかを示すインジケーター。'ReadRowNames' と、false または true で構成されるコンマ区切りのペアとして指定します。

インジケーター	説明
`false`	読み取る領域の最初の列にテーブルの行名ではなくデータが含まれている場合に使用します。
`true`	読み取る領域の最初の列にテーブルの行名が含まれている場合に使用します。
指定なし	指定のない場合、インポート関数は `false` と見なします。

データ型: logical

`MissingRule` — 欠損データを管理する方法
`'fill'` (既定値) | `'error'` | `'omitrow'` | `'omitvar'`

欠損データを管理する方法。次の表のいずれかの値として指定します。

欠損ルール	動作
`'fill'`	欠損データを `FillValue` プロパティの内容に置き換えます。 `FillValue` プロパティは、インポートされる変数の `VariableImportOptions` オブジェクトで指定されます。`FillValue` プロパティへのアクセスの詳細については、`getvaropts` を参照してください。
`'error'`	インポートを停止し、欠損しているレコードとフィールドを示すエラーメッセージを表示します。
`'omitrow'`	欠損データを含む行を除外します。
`'omitvar'`	欠損データを含む変数を除外します。

例: opts.MissingRule = 'omitrow';

データ型: char | string

`ImportErrorRule` — インポートエラーを処理する方法
`'fill'` (既定値) | `'error'` | `'omitrow'` | `'omitvar'`

インポートエラーを処理する方法。次の表のいずれかの値として指定します。

インポートエラールール	動作
`'fill'`	エラーが発生したデータを `FillValue` プロパティの内容に置き換えます。 `FillValue` プロパティは、インポートされる変数の `VariableImportOptions` オブジェクトで指定されます。`FillValue` プロパティへのアクセスの詳細については、`getvaropts` を参照してください。
`'error'`	インポートを停止し、エラーの原因となるレコードとフィールドを示すエラーメッセージを表示します。
`'omitrow'`	エラーが発生した行を除外します。
`'omitvar'`	エラーが発生した変数を除外します。

例: opts.ImportErrorRule = 'omitvar';

データ型: char | string

テキストファイルとスプレッドシートファイル

すべて折りたたむ

`ExpectedNumVariables` — 必要な変数の数
正の整数

必要な変数の数。'ExpectedNumVariables' と正の整数で構成されるコンマ区切りのペアとして指定します。指定しない場合、変数の数はインポート関数により自動検出されます。

データ型: single | double

`NumHeaderLines` — ヘッダーの行数
正の整数

ファイルのヘッダーの行数。'NumHeaderLines' と正の整数で構成されるコンマ区切りのペアとして指定します。指定しない場合、ファイルヘッダーの行数はインポート関数により自動検出されます。

例: 'NumHeaderLines',7

データ型: single | double

`Range` — 読み取るデータの部分
文字ベクトル | string スカラー | 数値ベクトル

テキストまたはスプレッドシートファイルから読み取るデータの部分。'Range' と、次のいずれかの形式をとる文字ベクトル、string スカラー、または数値ベクトルで構成されるコンマ区切りのペアとして指定します。

Range の指定方法説明

`Range` の指定方法	説明
開始セル `'Cell'` または `[row col]`	文字ベクトル、string スカラー、または 2 要素数値ベクトルとして、データの開始セルを指定します。 Excel の `A1` 表記法を使用した列の文字および行番号を含む文字ベクトルまたは string スカラー。たとえば、`A5` は列 `A` と行 `5` が交わる場所にあるセルの識別子です。開始行と開始列を示す `[row col]` 形式の 2 要素数値ベクトル。開始セルを使用して、インポート関数は、インポートを開始セルで開始し、最後の空の行またはフッター範囲で終了することで、データの範囲を自動的に検出します。例: `'A5'` または `[5 1]`
四角形の範囲 `'Corner1:Corner2'` または `[r1 c1 r2 c2]`	次の四角形の範囲フォームのいずれかを使用して、読み取る範囲を正確に指定します。 `'Corner1:Corner2'` — 読み取る領域を定義する 2 つの対角 `Corner1` および `Corner2` (Excel の `A1` 表記法) を使用して範囲を指定します。たとえば、`'C2:N15'` のようになります。 `[r1 c1 r2 c2]` — 開始行、開始列、終了行および終了列を含む 4 要素数値ベクトルを使用して範囲を指定します。たとえば、`[2 3 15 13]` のようになります。インポート関数は、指定された範囲内に含まれるデータのみを読み取ります。指定された範囲内の空のフィールドは欠損セルとしてインポートされます。
行範囲または列範囲 `'Row1:Row2'` または `'Column1:Column2'`	Excel の行番号を使用して、開始行と終了行を示して範囲を指定します。インポート関数は、指定された行範囲を使用して、最初の空でない列からデータの最後まで読み取ることにより、列の範囲を自動的に検出し、列ごとに 1 つの変数を作成します。例: `'5:500'` あるいは、Excel の列の文字または数字を使用して開始列と終了列を示して、範囲を指定します。インポート関数は、指定された列範囲を使用して、最初の空でない行からデータの最後またはフッター範囲まで読み取ることにより、行の範囲を自動的に検出します。指定された範囲の列数は `ExpectedNumVariables` プロパティで指定された数と一致しなければなりません。例: `'A:K'`
開始行番号 `n`	正のスカラー行インデックスを使用して、データを含む最初の行を指定します。インポート関数は、指定された行インデックスを使用して、指定された最初の行からデータの最後またはフッター範囲まで読み取ることにより、データの範囲を自動的に検出します。例: `5`
Excel の名前付き範囲 `'NamedRange'`	Excel では、スプレッドシート内の範囲を表す名前を作成できます。たとえば、スプレッドシートの四角形部分を選択して `'myTable'` という名前を付けることができます。スプレッドシート内にそのような名前付き範囲が存在する場合、インポート関数はその名前を使用して範囲を読み取ることができます。例: `'Range','myTable'`
指定なしまたは空 `''`	指定しない場合、使用範囲はインポート関数により自動検出されます。例: `'Range',''` メモ: "使用範囲" とは、スプレッドシート内で実際にデータが含まれている四角形部分を指します。インポート関数は、データを含まない先頭と末尾の行と列をすべてトリミングして、使用範囲を自動的に検出します。空白のみのテキストはデータと見なされ、使用範囲内に取得されます。

開始セル

'Cell' または [row col]

文字ベクトル、string スカラー、または 2 要素数値ベクトルとして、データの開始セルを指定します。

Excel の A1 表記法を使用した列の文字および行番号を含む文字ベクトルまたは string スカラー。たとえば、A5 は列 A と行 5 が交わる場所にあるセルの識別子です。
開始行と開始列を示す [row col] 形式の 2 要素数値ベクトル。

開始セルを使用して、インポート関数は、インポートを開始セルで開始し、最後の空の行またはフッター範囲で終了することで、データの範囲を自動的に検出します。

例: 'A5' または [5 1]

四角形の範囲

'Corner1:Corner2' または [r1 c1 r2 c2]

次の四角形の範囲フォームのいずれかを使用して、読み取る範囲を正確に指定します。

'Corner1:Corner2' — 読み取る領域を定義する 2 つの対角 Corner1 および Corner2 (Excel の A1 表記法) を使用して範囲を指定します。たとえば、'C2:N15' のようになります。
[r1 c1 r2 c2] — 開始行、開始列、終了行および終了列を含む 4 要素数値ベクトルを使用して範囲を指定します。たとえば、[2 3 15 13] のようになります。

インポート関数は、指定された範囲内に含まれるデータのみを読み取ります。指定された範囲内の空のフィールドは欠損セルとしてインポートされます。

行範囲または列範囲

'Row1:Row2' または 'Column1:Column2'

Excel の行番号を使用して、開始行と終了行を示して範囲を指定します。

インポート関数は、指定された行範囲を使用して、最初の空でない列からデータの最後まで読み取ることにより、列の範囲を自動的に検出し、列ごとに 1 つの変数を作成します。

例: '5:500'

あるいは、Excel の列の文字または数字を使用して開始列と終了列を示して、範囲を指定します。

インポート関数は、指定された列範囲を使用して、最初の空でない行からデータの最後またはフッター範囲まで読み取ることにより、行の範囲を自動的に検出します。

指定された範囲の列数は ExpectedNumVariables プロパティで指定された数と一致しなければなりません。

例: 'A:K'

開始行番号

n

正のスカラー行インデックスを使用して、データを含む最初の行を指定します。

インポート関数は、指定された行インデックスを使用して、指定された最初の行からデータの最後またはフッター範囲まで読み取ることにより、データの範囲を自動的に検出します。

例: 5

Excel の名前付き範囲

'NamedRange'

Excel では、スプレッドシート内の範囲を表す名前を作成できます。たとえば、スプレッドシートの四角形部分を選択して 'myTable' という名前を付けることができます。スプレッドシート内にそのような名前付き範囲が存在する場合、インポート関数はその名前を使用して範囲を読み取ることができます。

例: 'Range','myTable'

指定なしまたは空

''

指定しない場合、使用範囲はインポート関数により自動検出されます。

例: 'Range',''

メモ: "使用範囲" とは、スプレッドシート内で実際にデータが含まれている四角形部分を指します。インポート関数は、データを含まない先頭と末尾の行と列をすべてトリミングして、使用範囲を自動的に検出します。空白のみのテキストはデータと見なされ、使用範囲内に取得されます。

データ型: char | string | double

スプレッドシートファイル専用のパラメーター

すべて折りたたむ

`Sheet` — 読み取り元のシート
空の文字配列 `''` (既定値) | 文字ベクトル | string スカラー | 正のスカラー整数

読み取り元のシート。空の文字配列、シート名を含む文字ベクトルまたは string スカラー、あるいはシートインデックスを示す正の整数スカラーとして指定します。インポート関数は Sheet プロパティに指定された値に基づいて、表に説明されているように動作します。

指定	動作
`''` (既定)	1 番目のシートからデータをインポートします。
名前	スプレッドシートファイル内のシートの順序に関係なく、一致する名前のシートからデータをインポートします。
整数	スプレッドシートファイル内のシート名に関係なく、整数で示された位置にあるシートからデータをインポートします。

データ型: char | string | single | double

`DataRange` — データの場所
文字ベクトル | string スカラー | 正のスカラー整数 | 正のスカラー整数の配列 | 文字ベクトルの cell 配列 | string 配列

インポートするデータの場所。文字ベクトル、string スカラー、文字ベクトルの cell 配列、string 配列、正のスカラー整数、または N 行 2 列の正のスカラー整数の配列として指定します。これらの形式の 1 つを使用して DataRange を指定します。

指定方法動作

指定方法	動作
`'Cell'` または `n` 開始するセルまたは開始する行	Excel の `A1` 表記法を使用して、データの開始セルを指定します。たとえば、`A5` は列 `A` と行 `5` が交わる場所にあるセルの識別子です。開始セルを使用して、インポート関数は、インポートを開始セルで開始し、最後の空の行またはフッター範囲で終了することで、データの範囲を自動的に検出します。あるいは、正のスカラー行インデックスを使用して、データを含む最初の行を指定します。インポート関数は、指定された行インデックスを使用して、指定された最初の行からデータの最後またはフッター範囲まで読み取ることにより、データの範囲を自動的に検出します。例: `'A5'` または `5`
`'Corner1:Corner2'` 四角形の範囲	四角形の範囲フォームを使用して読み取る範囲を正確に指定します。`Corner1` と `Corner2` は読み取る範囲を定義する 2 つの対角です。インポート関数は、指定された範囲内に含まれるデータのみを読み取ります。指定された範囲内の空のフィールドは欠損セルとしてインポートされます。列数は `NumVariables` プロパティで指定された数と一致しなければなりません。例: `'A5:K50'`
`'Row1:Row2'` または `'Column1:Column2'` 行範囲または列範囲	Excel の行番号を使用して、開始行と終了行を示して範囲を指定します。インポート関数は、指定された行範囲を使用して、最初の空でない列からデータの最後まで読み取ることにより、列の範囲を自動的に検出し、列ごとに 1 つの変数を作成します。例: `'5:500'` あるいは、Excel の列の文字または数字を使用して開始列と終了列を示して、範囲を指定します。インポート関数は、指定された列範囲を使用して、最初の空でない行からデータの最後またはフッター範囲まで読み取ることにより、行の範囲を自動的に検出します。指定された範囲の列数は `NumVariables` プロパティで指定された数と一致しなければなりません。例: `'A:K'`
`[n1 n2; n3 n4;...]` 複数の行範囲	"複数の行範囲" を指定して、`N` の異なる行範囲を含む `N` 行 `2` 列の配列で読み取ります。有効な複数の行範囲の配列は、次でなければなりません。行の範囲は昇順で指定する。すなわち、配列で指定された最初の行範囲は、他の行範囲より、ファイル内で先に出現する。オーバーラップしない行範囲のみを含む。 `Inf` の使用は、複数の行範囲を指定する数値配列で最終行を示すためにのみサポートされます。たとえば、`[1 3; 5 6; 8 Inf]` とします。例: `[1 3; 5 6; 8 Inf]`
`''` 指定なしまたは空	データを取得しません。例: `''`

'Cell' または n

開始するセルまたは開始する行

Excel の A1 表記法を使用して、データの開始セルを指定します。たとえば、A5 は列 A と行 5 が交わる場所にあるセルの識別子です。

あるいは、正のスカラー行インデックスを使用して、データを含む最初の行を指定します。

例: 'A5' または 5

'Corner1:Corner2'

四角形の範囲

四角形の範囲フォームを使用して読み取る範囲を正確に指定します。Corner1 と Corner2 は読み取る範囲を定義する 2 つの対角です。

列数は NumVariables プロパティで指定された数と一致しなければなりません。

例: 'A5:K50'

'Row1:Row2' または 'Column1:Column2'

行範囲または列範囲

Excel の行番号を使用して、開始行と終了行を示して範囲を指定します。

例: '5:500'

あるいは、Excel の列の文字または数字を使用して開始列と終了列を示して、範囲を指定します。

指定された範囲の列数は NumVariables プロパティで指定された数と一致しなければなりません。

例: 'A:K'

[n1 n2; n3 n4;...]

複数の行範囲

"複数の行範囲" を指定して、N の異なる行範囲を含む N 行 2 列の配列で読み取ります。

有効な複数の行範囲の配列は、次でなければなりません。

行の範囲は昇順で指定する。すなわち、配列で指定された最初の行範囲は、他の行範囲より、ファイル内で先に出現する。
オーバーラップしない行範囲のみを含む。

Inf の使用は、複数の行範囲を指定する数値配列で最終行を示すためにのみサポートされます。たとえば、[1 3; 5 6; 8 Inf] とします。

例: [1 3; 5 6; 8 Inf]

''

指定なしまたは空

データを取得しません。

例: ''

データ型: char | string | cell | single | double

`RowNamesRange` — 行名の位置
文字ベクトル | string スカラー | 正のスカラー整数 | 空の文字配列 `''`

行名の位置。文字ベクトル、string スカラー、正のスカラー整数または空の文字配列として指定します。次の表のいずれかの値として RowNamesRange を指定します。

指定方法動作

指定方法	動作
`'Cell'`	Excel の `A1` 表記法を使用して、データの開始セルを指定します。たとえば、`A5` は列 `A` と行 `5` が交わる場所にあるセルの識別子です。インポート関数はデータ内の各変数の名前を識別します。例: `'A5'`
`'Corner1:Corner2'` 四角形の範囲	四角形の範囲フォームを使用して読み取る範囲を正確に指定します。`Corner1` と `Corner2` は読み取る範囲を定義する 2 つの対角です。 `RowNamesRange` に含まれる行数はデータの行数と一致しなければならず、`RowNamesRange` で示される範囲は 1 列のみでなければなりません。例: `'A5:A50'`
`'Row1:Row2'` 行範囲	Excel の行番号を使用して、開始行と終了行を示して範囲を指定します。行名は 1 列でなければなりません。例: `'5:50'`
`n` 数値インデックス	正のスカラー列インデックスを使用して、行名を含む列を指定します。例: `5`
`''` 指定なしまたは空	行名がないことを示します。例: `''`

'Cell'

Excel の A1 表記法を使用して、データの開始セルを指定します。たとえば、A5 は列 A と行 5 が交わる場所にあるセルの識別子です。

インポート関数はデータ内の各変数の名前を識別します。

例: 'A5'

'Corner1:Corner2'

四角形の範囲

四角形の範囲フォームを使用して読み取る範囲を正確に指定します。Corner1 と Corner2 は読み取る範囲を定義する 2 つの対角です。

RowNamesRange に含まれる行数はデータの行数と一致しなければならず、RowNamesRange で示される範囲は 1 列のみでなければなりません。

例: 'A5:A50'

'Row1:Row2'

行範囲

Excel の行番号を使用して、開始行と終了行を示して範囲を指定します。

行名は 1 列でなければなりません。

例: '5:50'

n

数値インデックス

正のスカラー列インデックスを使用して、行名を含む列を指定します。

例: 5

''

指定なしまたは空

行名がないことを示します。

例: ''

データ型: char | single | double

`VariableNamesRange` — 変数名の位置
文字ベクトル | string スカラー | 正のスカラー整数 | 空の文字配列 `''`

変数名の位置。文字ベクトル、string スカラー、正のスカラー整数または空の文字配列として指定します。次の表のいずれかの値として VariableNamesRange を指定します。

指定方法動作

指定方法	動作
`'Cell'`	Excel の `A1` 表記法を使用して、データの開始セルを指定します。たとえば、`A5` は列 `A` と行 `5` が交わる場所にあるセルの識別子です。インポート関数は、データ内の各変数の名前を読み取ります。例: `'A5'`
`'Corner1:Corner2'` 四角形の範囲	四角形の範囲フォームを使用して読み取る範囲を正確に指定します。`Corner1` と `Corner2` は読み取る範囲を定義する 2 つの対角です。列数は `NumVariables` プロパティで指定された数と一致しなければならず、範囲は 1 行のみでなければなりません。例: `'A5:K5'`
`'Row1:Row2'` 行範囲	Excel の行番号を使用して、開始行と終了行を示して範囲を指定します。 1 行でなければなりません。例: `'5:5'`
`n` 数値インデックス	正のスカラー行インデックスを使用して、変数名を含む行を指定します。例: `5`
`''` 指定なしまたは空	変数名がないことを示します。例: `''`

'Cell'

Excel の A1 表記法を使用して、データの開始セルを指定します。たとえば、A5 は列 A と行 5 が交わる場所にあるセルの識別子です。

インポート関数は、データ内の各変数の名前を読み取ります。

例: 'A5'

'Corner1:Corner2'

四角形の範囲

四角形の範囲フォームを使用して読み取る範囲を正確に指定します。Corner1 と Corner2 は読み取る範囲を定義する 2 つの対角です。

列数は NumVariables プロパティで指定された数と一致しなければならず、範囲は 1 行のみでなければなりません。

例: 'A5:K5'

'Row1:Row2'

行範囲

Excel の行番号を使用して、開始行と終了行を示して範囲を指定します。

1 行でなければなりません。

例: '5:5'

n

数値インデックス

正のスカラー行インデックスを使用して、変数名を含む行を指定します。

例: 5

''

指定なしまたは空

変数名がないことを示します。

例: ''

データ型: char | single | double

`VariableUnitsRange` — 変数の単位の位置
文字ベクトル | string スカラー | 正のスカラー整数 | 空の文字配列 `''`

変数の単位の位置。文字ベクトル、string スカラー、正のスカラー整数または空の文字配列として指定します。次の表のいずれかの値として VariableUnitsRange を指定します。

指定方法動作

指定方法	動作
`'Cell'`	Excel の `A1` 表記法を使用して、データの開始セルを指定します。たとえば、`A5` は列 `A` と行 `5` が交わる場所にあるセルの識別子です。インポート関数は、データ内の各変数の単位を読み取ります。例: `'A5'`
`'Corner1:Corner2'` 四角形の範囲	四角形の範囲フォームを使用して読み取る範囲を正確に指定します。`Corner1` と `Corner2` は読み取る範囲を定義する 2 つの対角です。列数は `NumVariables` プロパティで指定された数と一致しなければならず、範囲は 1 行のみでなければなりません。例: `'A5:K5'`
`'Row1:Row2'` 行範囲	Excel の行番号を使用して、開始行と終了行を示して範囲を指定します。 1 行でなければなりません。例: `'5:5'`
`n` 数値インデックス	正のスカラー行インデックスを使用して、データ単位を含む行を指定します。例: `5`
`''` 指定なしまたは空	変数の単位がないことを示します。例: `''`

'Cell'

Excel の A1 表記法を使用して、データの開始セルを指定します。たとえば、A5 は列 A と行 5 が交わる場所にあるセルの識別子です。

インポート関数は、データ内の各変数の単位を読み取ります。

例: 'A5'

'Corner1:Corner2'

四角形の範囲

四角形の範囲フォームを使用して読み取る範囲を正確に指定します。Corner1 と Corner2 は読み取る範囲を定義する 2 つの対角です。

列数は NumVariables プロパティで指定された数と一致しなければならず、範囲は 1 行のみでなければなりません。

例: 'A5:K5'

'Row1:Row2'

行範囲

Excel の行番号を使用して、開始行と終了行を示して範囲を指定します。

1 行でなければなりません。

例: '5:5'

n

数値インデックス

正のスカラー行インデックスを使用して、データ単位を含む行を指定します。

例: 5

''

指定なしまたは空

変数の単位がないことを示します。

例: ''

データ型: char | string | single | double

`VariableDescriptionsRange` — 変数の説明の位置
文字ベクトル | string スカラー | 空の文字配列 `''`

変数の説明の位置。文字ベクトル、string スカラー、正のスカラー整数または空の文字配列として指定します。次の表のいずれかの値として VariableDescriptionRange を指定します。

指定方法動作

指定方法	動作
`'Cell'`	Excel の `A1` 表記法を使用して、データの開始セルを指定します。たとえば、`A5` は列 `A` と行 `5` が交わる場所にあるセルの識別子です。インポート関数は、データ内の各変数の説明を読み取ります。例: `'A5'`
`'Corner1:Corner2'` 四角形の範囲	四角形の範囲フォームを使用して読み取る範囲を正確に指定します。`Corner1` と `Corner2` は読み取る範囲を定義する 2 つの対角です。列数は `NumVariables` プロパティで指定された数と一致しなければならず、範囲は 1 行のみでなければなりません。例: `'A5:K5'`
`'Row1:Row2'` 行範囲	Excel の行番号を使用して、開始行と終了行を示して範囲を指定します。 1 行でなければなりません。例: `'5:5'`
`n` 数値インデックス	正のスカラー行インデックスを使用して、説明を含む行を指定します。例: `5`
`''` 指定なしまたは空	変数の説明がないことを示します。例: `''`

'Cell'

Excel の A1 表記法を使用して、データの開始セルを指定します。たとえば、A5 は列 A と行 5 が交わる場所にあるセルの識別子です。

インポート関数は、データ内の各変数の説明を読み取ります。

例: 'A5'

'Corner1:Corner2'

四角形の範囲

四角形の範囲フォームを使用して読み取る範囲を正確に指定します。Corner1 と Corner2 は読み取る範囲を定義する 2 つの対角です。

列数は NumVariables プロパティで指定された数と一致しなければならず、範囲は 1 行のみでなければなりません。

例: 'A5:K5'

'Row1:Row2'

行範囲

Excel の行番号を使用して、開始行と終了行を示して範囲を指定します。

1 行でなければなりません。

例: '5:5'

n

数値インデックス

正のスカラー行インデックスを使用して、説明を含む行を指定します。

例: 5

''

指定なしまたは空

変数の説明がないことを示します。

例: ''

データ型: char | string | single | double

テキストファイル専用のパラメーター

すべて折りたたむ

`Delimiter` — フィールドの区切り記号
文字ベクトル | string スカラー | 文字ベクトルの cell 配列 | string 配列

区切りテキストファイル内のフィールドの区切り記号。文字ベクトル、string スカラー、文字ベクトルの cell 配列、または string 配列として指定します。

例: 'Delimiter','|'

例: 'Delimiter',{';','*'}

データ型: char | string | cell

`LeadingDelimitersRule` — 先頭の区切り記号を管理する方法
`'keep'` | `'ignore'` | `'error'`

区切りテキストファイル内の先頭の区切り記号を管理する方法。次の表の値のいずれかとして指定します。

先頭の区切り記号のルール	動作
`'keep'`	区切り記号を維持します。
`'ignore'`	区切り記号を無視します。
`'error'`	エラーを返し、インポート操作を中止します。

`TrailingDelimitersRule` — 末尾の区切り記号を管理する方法
`'keep'` | `'ignore'` | `'error'`

区切りテキストファイル内の末尾の区切り記号を管理する方法。次の表の値のいずれかとして指定します。

先頭の区切り記号のルール	動作
`'keep'`	区切り記号を維持します。
`'ignore'`	区切り記号を無視します。
`'error'`	エラーを返し、インポート操作を中止します。

`ConsecutiveDelimitersRule` — 連続する区切り記号を処理する方法
`'split'` | `'join'` | `'error'`

区切りテキストファイル内の連続する区切り記号を処理する方法。次の表の値のいずれかとして指定します。

連続する区切り記号のルール	動作
`'split'`	連続する区切り記号を複数のフィールドに分割します。
`'join'`	複数の区切り記号を結合して 1 つの区切り記号にします。
`'error'`	エラーを返し、インポート操作を中止します。

データ型: char | string

`VariableWidths` — 変数のフィールド幅
正の整数値のベクトル

固定幅のテキストファイルにおける変数のフィールド幅。正の整数値のベクトルとして指定します。ベクトルの正の整数はそれぞれ、フィールド内で変数を構成する文字数に対応します。VariableWidths プロパティには、VariableNames プロパティに指定された各変数に対応するエントリが含まれます。

`Whitespace` — 空白として扱う文字
文字ベクトル | string スカラー

空白として扱う文字。1 文字以上が含まれる文字ベクトルまたは string スカラーとして指定します。

例: 'Whitespace',' _'

例: 'Whitespace','?!.,'

`LineEnding` — 行末の文字
`{'\n','\r','\r\n'}` (既定値) | 文字ベクトル | string スカラー | 文字ベクトルの cell 配列 | string 配列

行末の文字。文字ベクトル、string スカラー、文字ベクトルの cell 配列、または string 配列として指定します。

例: 'LineEnding','\n'

例: 'LineEnding','\r\n'

例: 'LineEnding',{'\b',':'}

データ型: char | string | cell

`Encoding` — 文字エンコードスキーム
`''` | `'UTF-8'` | `'system'` | `'ISO-8859-1'` | `'windows-1251'` | `'windows-1252'` | ...

ファイルに関連付けられた文字エンコードスキーム。'Encoding' と 'system' で構成されるコンマ区切りのペア、または標準の文字エンコードスキーム名として指定します。

エンコードを指定しない場合、関数は自動文字セット検出を使用して、ファイルの読み取り時にエンコードを判断します。

例: 'Encoding','system' はシステムの既定のエンコードを使用します。

データ型: char | string

`CommentStyle` — コメントのスタイル
文字ベクトル | string スカラー | 文字ベクトルの cell 配列 | string 配列

コメントのスタイル。文字ベクトル、string スカラー、文字ベクトルの cell 配列、または string 配列として指定します。

たとえば、パーセント記号に続く同じ行のテキストを無視するには、CommentStyle を '%' に指定します。

例: 'CommentStyle',{'/*'}

データ型: char | string | cell

`DurationType` — duration データの出力データ型
`'duration'` (既定値) | `'text'`

テキストファイルからの duration データの出力データ型。'DurationType' と 'duration' または 'text' のいずれかで構成されるコンマ区切りのペアとして指定します。

値インポートされる duration データの型

値	インポートされる duration データの型
`'duration'`	MATLAB の `duration` データ型詳細については、`duration` を参照してください。
`'text'`	`'DurationType'` を `'text'` として指定した場合、インポートされる duration データの型は `'TextType'` パラメーターで指定された値によって決まります。 `'TextType'` が `'char'` に設定されている場合、インポート関数は duration データを文字ベクトルの cell 配列として返します。 `'TextType'` が `'string'` に設定されている場合、インポート関数は duration データを string の配列として返します。

'duration'

MATLAB の duration データ型

詳細については、duration を参照してください。

'text'

'DurationType' を 'text' として指定した場合、インポートされる duration データの型は 'TextType' パラメーターで指定された値によって決まります。

'TextType' が 'char' に設定されている場合、インポート関数は duration データを文字ベクトルの cell 配列として返します。
'TextType' が 'string' に設定されている場合、インポート関数は duration データを string の配列として返します。

データ型: char | string

`ExtraColumnsRule` — 余分な列を処理する方法
`'addvars'` | `'ignore'` | `'wrap'` | `'error'`

データ内の余分な列を処理する方法。次の表のいずれかの値として指定します。

余分な列のルール	動作
`'addvars'`	余分な列をインポートするには、新しい変数を作成します。余分な列が `N` 列ある場合、新しい変数を `'ExtraVar1', 'ExtraVar2',..., 'ExtraVarN'` としてインポートします。メモ: 余分な列はデータ型が `char` のテキストとしてインポートされます。
`'ignore'`	データの余分な列を無視します。
`'wrap'`	データの余分な列を新しいレコードにラップします。このアクションで変数の数は変わりません。
`'error'`	エラーメッセージを表示し、インポート操作を中止します。

データ型: char | string

`TreatAsMissing` — 欠損データとして解釈するテキスト
文字ベクトル | string スカラー | 文字ベクトルの cell 配列 | string 配列

欠損データとして解釈するテキスト。文字ベクトル、string スカラー、文字ベクトルの cell 配列、または string 配列として指定します。

インポート関数は、欠損インスタンスを見つけると、MissingRule プロパティ内の指定を使用して、適切なアクションを決定します。

例: 'TreatAsMissing',{'NA','TBD'} は、インポート関数に NA または TBD のすべての出現を欠損フィールドとして処理するように指示します。

データ型: char | string | cell

`DateLocale` — 日付を読み取るロケール
文字ベクトル | string スカラー

日付を読み取るロケール。'DateLocale' と、xx_YY の形式の文字ベクトルまたは string スカラーで構成されるコンマ区切りのペアとして指定します。ここで、次のようになります。

YY は国を表す大文字の ISO 3166-1 alpha-2 コード
xx は言語を表す小文字 2 文字の ISO 639-1 コード

ロケールの一般的な値の一覧については、関数 datetime の Locale の名前と値のペア引数を参照してください。

%D 書式指定子を使用してテキストを datetime 値として読み取る場合、DateLocale を使用して、インポート関数が月と曜日の名前および略語を解釈するためのロケールを指定します。

インポートオプション opts に加えて引数 DateLocale を指定した場合、インポート関数は引数 DateLocale で指定された値を使用して、インポートオプションで定義されたロケールをオーバーライドします。

例: 'DateLocale','ja_JP'

`ThousandsSeparator` — 3 桁ごとの区切りを示す文字
文字ベクトル | string スカラー

数値変数内の 3 桁ごとの区切りを示す文字。文字ベクトルまたは string スカラーとして指定します。3 桁ごとの区切り文字は視覚的な区切りとして機能し、数値を 3 桁ごとにグループ化します。インポート関数は、ThousandsSeparator プロパティの文字を使用して、インポートされる数値を解釈します。

データ型: char | string

`DecimalSeparator` — 小数点の区切りを示す文字
文字ベクトル | string スカラー

数値変数内の小数点の区切りを示す文字。文字ベクトルまたは string スカラーとして指定します。インポート関数は、DecimalSeparator プロパティを使用して、数値の整数部分と小数部分を区別します。

整数データ型に変換すると、小数部分をもつ数値は最も近い整数に丸められます。

データ型: char | string

`TrimNonNumeric` — 非数値文字の削除
`false` (既定値) | `true`

非数値文字を数値変数から削除します。logical true または false として指定します。

データ型: logical

`HexType` — 16 進数データの出力データ型
`'auto'` (既定値) | `'text'` | `'int8'` | `'int16'` | ...

16 進数データの出力データ型。'HexType' と表にリストされているいずれかの値で構成されるコンマ区切りのペアとして指定します。

入力ファイルは 16 進数値をテキストで表します。接頭辞として 0x または 0X を使用し、数字として文字 0 ～ 9、a ～ f、および A ～ F を使用します (大文字と小文字は同じ数値を表します。たとえば、'0xf' と '0xF' はどちらも 15 を表します)。

インポート関数は、16 進数の値を、'HexType' の値で指定されたデータ型に変換します。

`'HexType'` の値	出力テーブル変数のデータ型
`'auto'`	自動的に検出されるデータ型
`'text'`	変更されない入力テキスト
`'int8'`	8 ビット整数、符号付き
`'int16'`	16 ビット整数、符号付き
`'int32'`	32 ビット整数、符号付き
`'int64'`	64 ビット整数、符号付き
`'uint8'`	8 ビット整数、符号なし
`'uint16'`	16 ビット整数、符号なし
`'uint32'`	32 ビット整数、符号なし
`'uint64'`	64 ビット整数、符号なし

例: 'HexType','uint16' は、16 進数値を表すテキスト ('0xFF') を出力テーブルの符号なし 16 ビット整数 (255 など) に変換します。

データ型: char | string

`BinaryType` — バイナリデータの出力データ型
`'auto'` (既定値) | `'text'` | `'int8'` | `'int16'` | ...

バイナリデータの出力データ型。'BinaryType' と表にリストされているいずれかの値で構成されるコンマ区切りのペアとして指定します。

入力ファイルはバイナリ値をテキストで表します。接頭辞として 0b または 0B を使用し、数字として文字 0 と 1 を使用します。

インポート関数は、バイナリ値を 'BinaryType' の値で指定されたデータ型に変換します。

`'BinaryType'` の値	出力テーブル変数のデータ型
`'auto'`	自動的に検出されるデータ型
`'text'`	変更されない入力テキスト
`'int8'`	8 ビット整数、符号付き
`'int16'`	16 ビット整数、符号付き
`'int32'`	32 ビット整数、符号付き
`'int64'`	64 ビット整数、符号付き
`'uint8'`	8 ビット整数、符号なし
`'uint16'`	16 ビット整数、符号なし
`'uint32'`	32 ビット整数、符号なし
`'uint64'`	64 ビット整数、符号なし

例: 'BinaryType','uint16' は、バイナリ値を表すテキスト ('0b11111111' など) を出力テーブルの符号なし 16 ビット整数 (255 など) に変換します。

データ型: char | string

XML ファイルのみ

すべて折りたたむ

`ImportAttributes` — 属性のインポート
logical `1` または `true` (既定値) | logical `0` または `false`

属性のインポート。'ImportAttributes' と、1 (true) または 0 (false) のいずれかで構成されるコンマ区切りのペアとして指定します。false を指定すると、読み取り関数は入力ファイル内の XML 属性を出力 table に変数としてインポートしません。

例: 'ImportAttributes',false

`AttributeSuffix` — 属性接尾辞
`'Attribute'` (既定値) | 文字ベクトル | string スカラー

属性接尾辞。'AttributeSuffix' と文字ベクトルまたは string スカラーのいずれかで構成されるコンマ区切りのペアとして指定します。この引数は、読み取り関数が入力 XML ファイルに含まれる属性に対応するすべての table 変数に付加する接尾辞を指定します。'AttributeSuffix' を指定しない場合、読み取り関数は既定で接尾辞 'Attribute' を入力 XML ファイルに含まれる属性に対応するすべての変数名に付加します。

例: 'AttributeSuffix','_att'

`RowNodeName` — table 行の XML ノード名
文字ベクトル | string 配列

table 行の XML ノード名。'RowNodeName' と文字ベクトルまたは string スカラーのいずれかで構成されるコンマ区切りのペアとして指定します。この引数は、出力 table の行を区切る XML ノード名を指定します。

例: 'RowNodeName','XMLNodeName'

`RowSelector` — table 行の XPath 式
文字ベクトル | string スカラー

table 行の XPath 式。文字ベクトルまたは string スカラーとして指定します。読み取り関数は、これを使用して出力 table の個々の行を選択します。RowSelector には有効な XPath Version 1.0 の式を指定しなければなりません。

例: 'RowSelector','/RootNode/ChildNode'

`VariableNodeNames` — table 変数の XML ノード名
文字ベクトルの cell 配列 | string 配列

table 変数の XML ノード名。'VariableNodeNames' と文字ベクトルの cell 配列または string 配列のいずれかで構成されるコンマ区切りのペアとして指定します。この引数は、読み取り関数が出力 table に変数として読み取る XML ノードを識別するために使用する XML ノード名を指定します。

例: 'VariableNodeNames',{'XMLNodeName1','XMLNodeName2'}

例: 'VariableNodeNames',"XMLNodeName"

例: 'VariableNodeNames',["XMLNodeName1","XMLNodeName2"]

`VariableSelectors` — table 変数の XPath 式
文字ベクトルの cell 配列 | string 配列

table 変数の XPath 式。文字ベクトルの cell 配列または string 配列として指定します。読み取り関数は、これを使用して table 変数を選択します。VariableSelectors には有効な XPath Version 1.0 の式を指定しなければなりません。

例: 'VariableSelectors',{'/RootNode/ChildNode'}

例: 'VariableSelectors',"/RootNode/ChildNode"

例: 'VariableSelectors',["/RootNode/ChildNode1","/RootNode/ChildNode2"]

`TableNodeName` — table の XML ノード名
文字ベクトル | string スカラー

table の XML ノード名。'TableNodeName' と文字ベクトルまたは string スカラーのいずれかで構成されるコンマ区切りのペアとして指定します。この引数は、読み取り関数が table に読み取る入力構造体のノードを指定します。

例: 'TableNodeName','NodeName'

`TableSelector` — table データの XPath 式
文字ベクトル | string スカラー

table データの XPath 式。文字ベクトルまたは string スカラーとして指定します。読み取り関数は、これを使用して出力 table のデータを選択します。TableSelector には有効な XPath Version 1.0 の式を指定しなければなりません。

例: 'TableSelector','/RootNode/ChildNode'

`VariableUnitsSelector` — 変数の単位の XPath 式
文字ベクトル | string スカラー

変数の単位の XPath。文字ベクトルまたは string スカラーとして指定します。読み取り関数は、これを使用して table 変数の単位を選択します。VariableUnitsSelector には有効な XPath Version 1.0 の式を指定しなければなりません。

例: 'VariableUnitsSelector','/RootNode/ChildNode'

`VariableDescriptionsSelector` — 変数の説明の XPath 式
文字ベクトル | string スカラー

変数の説明の XPath 式。文字ベクトルまたは string スカラーとして指定します。読み取り関数は、これを使用して table 変数の説明を選択します。VariableDescriptionsSelector には有効な XPath Version 1.0 の式を指定しなければなりません。

例: 'VariableDescriptionsSelector','/RootNode/ChildNode'

`RowNamesSelector` — table 行の名前の XPath 式
文字ベクトル | string スカラー

table 行の名前の XPath 式。文字ベクトルまたは string スカラーとして指定します。読み取り関数は、これを使用して table 行の名前を選択します。RowNamesSelector には有効な XPath Version 1.0 の式を指定しなければなりません。

例: 'RowNamesSelector','/RootNode/ChildNode'

`RepeatedNodeRule` — 繰り返し XML ノードの処理方法
`'addcol'` (既定値) | `'ignore'` | `'error'`

table の特定の行における繰り返し XML ノードの処理方法。'addcol'、'ignore'、または 'error' として指定します。

繰り返しノードの規則	動作
`'addcol'`	table の変数ヘッダーの下に繰り返しノード用の列を追加します。`'RepeatedNodeRule'` の値を `'addcol'` と指定しても、table に繰り返しノードに対する別個の変数は作成されません。
`'ignore'`	繰り返しノードはスキップしてインポートします。
`'error'`	エラーメッセージを表示し、インポート操作を中止します。

例: 'RepeatedNodeRule','ignore'

`RegisteredNamespaces` — 登録済みの XML 名前空間接頭辞のセット
string 配列

登録済みの XML 名前空間接頭辞のセット。RegisteredNamespaces と接頭辞の配列で構成されるコンマ区切りのペアとして指定します。読み取り関数は、XML ファイルの XPath 式を評価する際にこれらの接頭辞を使用します。名前空間接頭辞とそれに関連付けられた URL を N 行 2 列の string 配列として指定します。RegisteredNamespaces は、readstruct の StructSelector や readtable と readtimetable の VariableSelectors など、セレクターの名前と値の引数で指定された XPath 式も評価する場合に使用できます。

既定では、読み取り関数は XPath の評価に使用する名前空間接頭辞を自動的に検出して登録しますが、名前と値の引数 RegisteredNamespaces を使用して新しい名前空間接頭辞を登録することもできます。新しい名前空間接頭辞の登録は、名前空間 URL がある XML ノードについて、XML ファイルで名前空間接頭辞が宣言されていない場合などに便利です。

たとえば、名前空間接頭辞が含まれていない example.xml という名前の XML ファイルの XPath 式を評価するとします。'RegisteredNamespaces' を [“myprefix”, “https://www.mathworks.com”] と指定して、接頭辞 myprefix を URL https://www.mathworks.com に割り当てます。

T = readtable("example.xml", "VariableSelector", "/myprefix:Data",...
 "RegisteredNamespaces", [“myprefix”, “https://www.mathworks.com”])

例: 'RegisteredNamespaces',[“myprefix”, “https://www.mathworks.com”]

出力引数

すべて折りたたむ

`opts` — ファイルのインポートオプション
`SpreadsheetImportOptions` | `DelimitedtextImportOptions` | `FixedWidthImportOptions` | `XMLImportOptions`

指定されたファイルのインポートオプション。SpreadsheetImportOptions オブジェクト、DelimitedTextImportOptions オブジェクト、FixedWidthImportOptions オブジェクトまたは XMLImportOptions オブジェクトとして返されます。オプションオブジェクトのタイプは、指定したファイルの種類によって決まります。テキストファイル (.txt、.dat または .csv) の場合、関数 detectImportOptions は DelimitedTextImportOptions オブジェクトまたは FixedWidthImportOptions オブジェクトを返します。スプレッドシートファイル (.xls、.xlsb、.xlsm、.xlsx、.xltm、.xltx または .ods) の場合、関数 detectImportOptions は SpreadsheetImportOptions オブジェクトを返します。XML ファイル (.xml) の場合、detectImportOptions は XMLImportOptions オブジェクトを返します。

ヒント

インポートオプションオブジェクト作成後のプロパティ値の更新: detecImportOptions で作成されたインポートオプションオブジェクトのプロパティをドット表記を使用して更新することは推奨されません。ドット表記を使用してプロパティを設定すると、MATLAB はファイルのすべてのインポートオプションを再検出するわけではありません。したがって、すべてのプロパティを更新して再検出するには、名前と値の引数を使用して新しい値を指定しなければなりません。たとえば、次のようにして、ConsecutiveDelimitersRule プロパティの値を更新してインポートオプションを再検出します。
```
opts = detectImportOptions(__,'ConsecutiveDelimitersRule','join')
```
RowSelector や VariableSelector などの XPath セレクターの名前と値の引数では、次の XPath 構文がサポートされます。
- ドキュメント内の場所に関係なく、選択するノードに名前が一致するすべてのノードを選択するには、"//myNode" 構文を使用します。"//myNode" を使用すると、XPath 式の選択するノードより前の部分を省略できます。
- ファイル内の 1 つの親ノードの配下にあるいくつかの兄弟ノードの 1 つを読み取るには、ChildNode[n] を指定できます。ここで、n は、インデックスを付ける兄弟ノードに対応します。たとえば、パス "/RootNode/ChildNode[2]" は、親が RootNode である 2 つ目の ChildNode 要素を選択します。
- 入力 XML ファイル内の、ある要素ノードに属する 1 つの属性の値を読み取るには、属性名の前に @ を指定します。たとえば、"/RootNode/ChildNode[2]/@AttributeName" は、親が RootNode である 2 つ目の ChildNode 要素に属する属性 AttributeName を選択します。

参考

SpreadsheetImportOptions | FixedWidthImportOptions | DelimitedTextImportOptions | XMLImportOptions | readtable

トピック

テーブルのインポートオプションの定義

R2016b で導入

detectImportOptions

構文

説明

例

スプレッドシート ファイルのインポート オプションの検出と使用

テキスト ファイルのインポート オプションの検出と使用

インポートされるテキスト データのデータ型の指定

カスタムの XML 名前空間接頭辞の登録

入力引数

filename — 読み取るファイルの名前 文字ベクトル | string スカラー

名前と値のペアの引数

FileType — ファイルの種類 'spreadsheet' | 'text' | 'delimitedtext' | 'fixedwidth' | 'xml'

TextType — インポートされるテキスト データの型 'char' (既定値) | 'string'

DatetimeType — インポートされる日付と時刻のデータの型 'datetime' (既定値) | 'text' | 'exceldatenum' (スプレッドシート ファイルのみ)

ReadVariableNames — 最初の行を変数名として読み取る true | false

VariableNamingRule — 変数名を保持するかどうかのフラグ 'modify' (既定値) | 'preserve'

ReadRowNames — 最初の列を行名として読み取るかどうかを示すインジケーター false (既定値) | true

MissingRule — 欠損データを管理する方法 'fill' (既定値) | 'error' | 'omitrow' | 'omitvar'

ImportErrorRule — インポート エラーを処理する方法 'fill' (既定値) | 'error' | 'omitrow' | 'omitvar'

ExpectedNumVariables — 必要な変数の数 正の整数

NumHeaderLines — ヘッダーの行数 正の整数

Range — 読み取るデータの部分 文字ベクトル | string スカラー | 数値ベクトル

Sheet — 読み取り元のシート 空の文字配列 '' (既定値) | 文字ベクトル | string スカラー | 正のスカラー整数

DataRange — データの場所 文字ベクトル | string スカラー | 正のスカラー整数 | 正のスカラー整数の配列 | 文字ベクトルの cell 配列 | string 配列

RowNamesRange — 行名の位置 文字ベクトル | string スカラー | 正のスカラー整数 | 空の文字配列 ''

VariableNamesRange — 変数名の位置 文字ベクトル | string スカラー | 正のスカラー整数 | 空の文字配列 ''

VariableUnitsRange — 変数の単位の位置 文字ベクトル | string スカラー | 正のスカラー整数 | 空の文字配列 ''

VariableDescriptionsRange — 変数の説明の位置 文字ベクトル | string スカラー | 空の文字配列 ''

Delimiter — フィールドの区切り記号 文字ベクトル | string スカラー | 文字ベクトルの cell 配列 | string 配列

LeadingDelimitersRule — 先頭の区切り記号を管理する方法 'keep' | 'ignore' | 'error'

TrailingDelimitersRule — 末尾の区切り記号を管理する方法 'keep' | 'ignore' | 'error'

ConsecutiveDelimitersRule — 連続する区切り記号を処理する方法 'split' | 'join' | 'error'

VariableWidths — 変数のフィールド幅 正の整数値のベクトル

Whitespace — 空白として扱う文字 文字ベクトル | string スカラー

LineEnding — 行末の文字 {'\n','\r','\r\n'} (既定値) | 文字ベクトル | string スカラー | 文字ベクトルの cell 配列 | string 配列

Encoding — 文字エンコード スキーム '' | 'UTF-8' | 'system' | 'ISO-8859-1' | 'windows-1251' | 'windows-1252' | ...

CommentStyle — コメントのスタイル 文字ベクトル | string スカラー | 文字ベクトルの cell 配列 | string 配列

DurationType — duration データの出力データ型 'duration' (既定値) | 'text'

ExtraColumnsRule — 余分な列を処理する方法 'addvars' | 'ignore' | 'wrap' | 'error'

TreatAsMissing — 欠損データとして解釈するテキスト 文字ベクトル | string スカラー | 文字ベクトルの cell 配列 | string 配列

DateLocale — 日付を読み取るロケール 文字ベクトル | string スカラー

ThousandsSeparator — 3 桁ごとの区切りを示す文字 文字ベクトル | string スカラー

DecimalSeparator — 小数点の区切りを示す文字 文字ベクトル | string スカラー

TrimNonNumeric — 非数値文字の削除 false (既定値) | true

HexType — 16 進数データの出力データ型 'auto' (既定値) | 'text' | 'int8' | 'int16' | ...

BinaryType — バイナリ データの出力データ型 'auto' (既定値) | 'text' | 'int8' | 'int16' | ...

ImportAttributes — 属性のインポート logical 1 または true (既定値) | logical 0 または false

AttributeSuffix — 属性接尾辞 'Attribute' (既定値) | 文字ベクトル | string スカラー

RowNodeName — table 行の XML ノード名 文字ベクトル | string 配列

RowSelector — table 行の XPath 式 文字ベクトル | string スカラー

VariableNodeNames — table 変数の XML ノード名 文字ベクトルの cell 配列 | string 配列

VariableSelectors — table 変数の XPath 式 文字ベクトルの cell 配列 | string 配列

TableNodeName — table の XML ノード名 文字ベクトル | string スカラー

TableSelector — table データの XPath 式 文字ベクトル | string スカラー

VariableUnitsSelector — 変数の単位の XPath 式 文字ベクトル | string スカラー

VariableDescriptionsSelector — 変数の説明の XPath 式 文字ベクトル | string スカラー

RowNamesSelector — table 行の名前の XPath 式 文字ベクトル | string スカラー

RepeatedNodeRule — 繰り返し XML ノードの処理方法 'addcol' (既定値) | 'ignore' | 'error'

RegisteredNamespaces — 登録済みの XML 名前空間接頭辞のセット string 配列

出力引数

opts — ファイルのインポート オプション SpreadsheetImportOptions | DelimitedtextImportOptions | FixedWidthImportOptions | XMLImportOptions

ヒント

参考

トピック

MATLAB ドキュメンテーション

サポート

MATLABで始めるディープラーニング

スプレッドシートファイルのインポートオプションの検出と使用

テキストファイルのインポートオプションの検出と使用

インポートされるテキストデータのデータ型の指定

`filename` — 読み取るファイルの名前
文字ベクトル | string スカラー

`FileType` — ファイルの種類
`'spreadsheet'` | `'text'` | `'delimitedtext'` | `'fixedwidth'` | `'xml'`

`TextType` — インポートされるテキストデータの型
`'char'` (既定値) | `'string'`

`DatetimeType` — インポートされる日付と時刻のデータの型
`'datetime'` (既定値) | `'text'` | `'exceldatenum'` (スプレッドシートファイルのみ)

`ReadVariableNames` — 最初の行を変数名として読み取る
`true` | `false`

`VariableNamingRule` — 変数名を保持するかどうかのフラグ
`'modify'` (既定値) | `'preserve'`

`ReadRowNames` — 最初の列を行名として読み取るかどうかを示すインジケーター
`false` (既定値) | `true`

`MissingRule` — 欠損データを管理する方法
`'fill'` (既定値) | `'error'` | `'omitrow'` | `'omitvar'`

`ImportErrorRule` — インポートエラーを処理する方法
`'fill'` (既定値) | `'error'` | `'omitrow'` | `'omitvar'`

`ExpectedNumVariables` — 必要な変数の数
正の整数

`NumHeaderLines` — ヘッダーの行数
正の整数

`Range` — 読み取るデータの部分
文字ベクトル | string スカラー | 数値ベクトル

`Sheet` — 読み取り元のシート
空の文字配列 `''` (既定値) | 文字ベクトル | string スカラー | 正のスカラー整数

`DataRange` — データの場所
文字ベクトル | string スカラー | 正のスカラー整数 | 正のスカラー整数の配列 | 文字ベクトルの cell 配列 | string 配列

`RowNamesRange` — 行名の位置
文字ベクトル | string スカラー | 正のスカラー整数 | 空の文字配列 `''`

`VariableNamesRange` — 変数名の位置
文字ベクトル | string スカラー | 正のスカラー整数 | 空の文字配列 `''`

`VariableUnitsRange` — 変数の単位の位置
文字ベクトル | string スカラー | 正のスカラー整数 | 空の文字配列 `''`

`VariableDescriptionsRange` — 変数の説明の位置
文字ベクトル | string スカラー | 空の文字配列 `''`

`Delimiter` — フィールドの区切り記号
文字ベクトル | string スカラー | 文字ベクトルの cell 配列 | string 配列

`LeadingDelimitersRule` — 先頭の区切り記号を管理する方法
`'keep'` | `'ignore'` | `'error'`

`TrailingDelimitersRule` — 末尾の区切り記号を管理する方法
`'keep'` | `'ignore'` | `'error'`

`ConsecutiveDelimitersRule` — 連続する区切り記号を処理する方法
`'split'` | `'join'` | `'error'`

`VariableWidths` — 変数のフィールド幅
正の整数値のベクトル

`Whitespace` — 空白として扱う文字
文字ベクトル | string スカラー

`LineEnding` — 行末の文字
`{'\n','\r','\r\n'}` (既定値) | 文字ベクトル | string スカラー | 文字ベクトルの cell 配列 | string 配列

`Encoding` — 文字エンコードスキーム
`''` | `'UTF-8'` | `'system'` | `'ISO-8859-1'` | `'windows-1251'` | `'windows-1252'` | ...

`CommentStyle` — コメントのスタイル
文字ベクトル | string スカラー | 文字ベクトルの cell 配列 | string 配列

`DurationType` — duration データの出力データ型
`'duration'` (既定値) | `'text'`

`ExtraColumnsRule` — 余分な列を処理する方法
`'addvars'` | `'ignore'` | `'wrap'` | `'error'`

`TreatAsMissing` — 欠損データとして解釈するテキスト
文字ベクトル | string スカラー | 文字ベクトルの cell 配列 | string 配列

`DateLocale` — 日付を読み取るロケール
文字ベクトル | string スカラー

`ThousandsSeparator` — 3 桁ごとの区切りを示す文字
文字ベクトル | string スカラー

`DecimalSeparator` — 小数点の区切りを示す文字
文字ベクトル | string スカラー

`TrimNonNumeric` — 非数値文字の削除
`false` (既定値) | `true`

`HexType` — 16 進数データの出力データ型
`'auto'` (既定値) | `'text'` | `'int8'` | `'int16'` | ...

`BinaryType` — バイナリデータの出力データ型
`'auto'` (既定値) | `'text'` | `'int8'` | `'int16'` | ...

`ImportAttributes` — 属性のインポート
logical `1` または `true` (既定値) | logical `0` または `false`

`AttributeSuffix` — 属性接尾辞
`'Attribute'` (既定値) | 文字ベクトル | string スカラー

`RowNodeName` — table 行の XML ノード名
文字ベクトル | string 配列

`RowSelector` — table 行の XPath 式
文字ベクトル | string スカラー

`VariableNodeNames` — table 変数の XML ノード名
文字ベクトルの cell 配列 | string 配列

`VariableSelectors` — table 変数の XPath 式
文字ベクトルの cell 配列 | string 配列

`TableNodeName` — table の XML ノード名
文字ベクトル | string スカラー

`TableSelector` — table データの XPath 式
文字ベクトル | string スカラー

`VariableUnitsSelector` — 変数の単位の XPath 式
文字ベクトル | string スカラー

`VariableDescriptionsSelector` — 変数の説明の XPath 式
文字ベクトル | string スカラー

`RowNamesSelector` — table 行の名前の XPath 式
文字ベクトル | string スカラー

`RepeatedNodeRule` — 繰り返し XML ノードの処理方法
`'addcol'` (既定値) | `'ignore'` | `'error'`

`RegisteredNamespaces` — 登録済みの XML 名前空間接頭辞のセット
string 配列

`opts` — ファイルのインポートオプション
`SpreadsheetImportOptions` | `DelimitedtextImportOptions` | `FixedWidthImportOptions` | `XMLImportOptions`