detectImportOptions
ファイルの内容に基づくインポート オプションの作成
説明
は、ファイル内のテーブルを検索し、そのインポート オプションを返します。オプション オブジェクトを変更し、それを opts
= detectImportOptions(filename
)readtable
とともに使用して、MATLAB® がテーブル データをインポートする方法を制御できます。返されるオプションのタイプは、ファイル拡張子によって決まります。たとえば、filename
がスプレッドシート ファイルの場合、関数は SpreadsheetImportOptions
オブジェクトを返します。一方で、この関数は filename
がテキスト ファイルの場合は DelimitedTextImportOptions
オブジェクトまたは FixedWidthImportOptions
オブジェクト、filename
が XML ファイルの場合は XMLImportOptions
オブジェクト、filename
が HTML ファイルの場合は HTMLImportOptions
オブジェクト、filename
が Microsoft® Word ドキュメントの場合は WordDocumentImportOptions
オブジェクトを返します。
は、1 つ以上の opts
= detectImportOptions(filename
,Name,Value
)Name,Value
ペアの引数によって指定された追加パラメーターを使用して、ファイル内のテーブルを検索します。
例
インポート オプションを使用したスプレッドシート ファイルの読み取り
インポート オプション オブジェクトを使用して、readtable でファイルを解釈する方法を構成します。たとえば、インポート オプション オブジェクトを使用して、スプレッドシート ファイルから指定した変数のみを読み取ります。
まず、変数の名前と型など、スプレッドシート ファイルの要素を検出するために detectImportOptions
を使用してファイルからインポート オプション オブジェクトを作成します。この場合、detectImportOptions
は SpreadsheetImportOptions
オブジェクトを作成します。
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: [1-by-10 matlab.io.VariableImportOptions] 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
インポート オプション オブジェクトを変更して、インポートする変数を指定します。次に、インポート オプション オブジェクトを指定して readtable
を使用し、指定した変数をインポートします。table の最初の 5 行を表示します。
opts.SelectedVariableNames = ["Systolic","Diastolic"]; T = readtable("patients.xls",opts); T(1:5,:)
ans=5×2 table
Systolic Diastolic
________ _________
124 93
109 77
125 83
117 75
122 80
インポート オプションを使用したテキスト ファイルのサブセットの読み取り
インポート オプション オブジェクトを使用して、readtable
でファイルを解釈する方法を構成します。たとえば、インポート オプション オブジェクトを使用してテキスト ファイルのサブセットのみを読み取ります。
まず、変数の名前と型、区切り記号、空白文字など、テキスト ファイルの要素を検出するために detectImportOptions
を使用してインポート オプション オブジェクトを作成します。この場合、detectImportOptions
は DelimitedTextImportOptions
オブジェクトを作成します。
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: [1-by-29 matlab.io.VariableImportOptions] 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
インポート オプション オブジェクトを変更して、インポートする変数のサブセットを指定します。次に、インポート オプション オブジェクトを指定して readtable
を使用し、データのサブセットをインポートします。
opts.SelectedVariableNames = ["TaxiIn","TaxiOut"]; T = readtable("airlinesmall.csv",opts);
Microsoft Word ドキュメント ファイルのインポート オプションの検出と使用
Word Document ドキュメント ファイルのインポート オプションを検出し、インポートするテーブルを指定してから、データを読み取ります。
ファイル MaintenanceReport.docx
にはテーブルが 2 つ含まれています。2 つ目のテーブルの最後の行に、テーブルの変数と一致しない、列がマージされたセルがあります。
関数 detectImportOptions
を使用してインポート オプションを検出します。TableIndex
を 2
に設定して 2 つ目のテーブルから読み取るように指定します。
filename = "MaintenanceReport.docx"; opts = detectImportOptions(filename,'TableIndex',2)
opts = WordDocumentImportOptions with properties: Replacement Properties: MissingRule: "fill" ImportErrorRule: "fill" EmptyRowRule: "skip" MergedCellColumnRule: "placeleft" MergedCellRowRule: "placetop" ExtraColumnsRule: "addvars" Variable Import Properties: Set types by name using setvartype VariableNames: ["Description" "Category" "Urgency" "Resolution" "Cost"] VariableTypes: ["string" "string" "string" "string" "string"] SelectedVariableNames: ["Description" "Category" "Urgency" "Resolution" "Cost"] VariableOptions: [1-by-5 matlab.io.VariableImportOptions] Access VariableOptions sub-properties using setvaropts/getvaropts VariableNamingRule: "preserve" Location Properties: TableSelector: "(//w:tbl)[2]" DataRows: [2 Inf] VariableNamesRow: 1 VariableUnitsRow: 0 VariableDescriptionsRow: 0 RowNamesColumn: 0
列がマージされたセルがある行の読み取りをスキップするために、MergedCellColumnRule
プロパティを 'omitrow'
に設定します。
opts.MergedCellColumnRule = 'omitrow';
関数 readtable
でオプション オブジェクトを使用して、Microsoft Word ドキュメント ファイルからテーブルを読み取ります。
filename = "MaintenanceReport.docx";
T = readtable(filename,opts)
T=3×5 table
Description Category Urgency Resolution Cost
_____________________________________________________________________ ____________________ ________ __________________ ________
"Items are occasionally getting stuck in the scanner spools." "Mechanical Failure" "Medium" "Readjust Machine" "$45"
"Loud rattling and banging sounds are coming from assembler pistons." "Mechanical Failure" "Medium" "Readjust Machine" "$35"
"There are cuts to the power when starting the plant." "Electronic Failure" "High" "Full Replacement" "$16200"
HTML ファイルのインポート オプションの検出と使用
HTML ファイルのインポート オプションを検出し、インポートするテーブルを指定してから、データを読み取ります。
URL https://www.mathworks.com/help/matlab/text-files.html
から「readtable」というテキストを含む最初のテーブルのインポート オプションを検出します。関数 detectImportOptions
を使用してインポート オプションを検出し、読み取るテーブルを XPath クエリ "//TABLE[contains(.,'readtable')]"
を使用して指定します。ReadVariableNames
を false
に設定して変数名を読み取らないように指定します。
url = "https://www.mathworks.com/help/matlab/text-files.html"; opts = detectImportOptions(url,'TableSelector',"//TABLE[contains(.,'readtable')]",'ReadVariableNames',false)
opts = HTMLImportOptions with properties: Replacement Properties: MissingRule: "fill" ImportErrorRule: "fill" EmptyRowRule: "skip" MergedCellColumnRule: "placeleft" MergedCellRowRule: "placetop" ExtraColumnsRule: "addvars" Variable Import Properties: Set types by name using setvartype VariableNames: ["Var1" "Var2"] VariableTypes: ["string" "string"] SelectedVariableNames: ["Var1" "Var2"] VariableOptions: Show all 2 VariableOptions Access VariableOptions sub-properties using setvaropts/getvaropts VariableNamingRule: "preserve" Location Properties: TableSelector: "//TABLE[contains(.,'readtable')]" DataRows: [1 Inf] VariableNamesRow: 0 VariableUnitsRow: 0 VariableDescriptionsRow: 0 RowNamesColumn: 0
関数 readtable
を使用してテーブルを読み取ります。
T = readtable(url,opts)
T=4×2 table
Var1 Var2
________________ ____________________________
"readtable" "Create table from file"
"writetable" "Write table to file"
"readtimetable" "Create timetable from file"
"writetimetable" "Write timetable to file"
インポートされるテキスト データのデータ型の指定
インポート オプションを指定して、テキスト データを 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 ファイルの table としての読み取り
XML ファイルの内容を table にインポートします。
students.xml
ファイルには、Student
という名前の 7 つの兄弟ノードがあり、それぞれに同じ子ノードと属性が含まれています。
type students.xml
<?xml version="1.0" encoding="utf-8"?> <Students> <Student ID="S11305"> <Name FirstName="Priya" LastName="Thompson" /> <Age>18</Age> <Year>Freshman</Year> <Address> <Street xmlns="https://www.mathworks.com">591 Spring Lane</Street> <City>Natick</City> <State>MA</State> </Address> <Major>Computer Science</Major> <Minor>English Literature</Minor> </Student> <Student ID="S23451"> <Name FirstName="Conor" LastName="Cole" /> <Age>18</Age> <Year>Freshman</Year> <Address> <Street xmlns="https://www.mathworks.com">4641 Pearl Street</Street> <City>San Francisco</City> <State>CA</State> </Address> <Major>Microbiology</Major> <Minor>Public Health</Minor> </Student> <Student ID="S119323"> <Name FirstName="Morgan" LastName="Yang" /> <Age>21</Age> <Year>Senior</Year> <Address> <Street xmlns="https://www.mathworks.com">30 Highland Road</Street> <City>Detriot</City> <State>MI</State> </Address> <Major>Political Science</Major> </Student> <Student ID="S201351"> <Name FirstName="Salim" LastName="Copeland" /> <Age>19</Age> <Year>Sophomore</Year> <Address> <Street xmlns="https://www.mathworks.com">3388 Moore Avenue</Street> <City>Fort Worth</City> <State>TX</State> </Address> <Major>Business</Major> <Minor>Japanese Language</Minor> </Student> <Student ID="S201351"> <Name FirstName="Salim" LastName="Copeland" /> <Age>20</Age> <Year>Sophomore</Year> <Address> <Street xmlns="https://www.mathworks.com">3388 Moore Avenue</Street> <City>Fort Worth</City> <State>TX</State> </Address> <Major>Business</Major> <Minor>Japanese Language</Minor> </Student> <Student ID="54600"> <Name FirstName="Dania" LastName="Burt" /> <Age>22</Age> <Year>Senior</Year> <Address> <Street xmlns="https://www.mathworks.com">22 Angie Drive</Street> <City>Los Angeles</City> <State>CA</State> </Address> <Major>Mechanical Engineering</Major> <Minor>Architecture</Minor> </Student> <Student ID="453197"> <Name FirstName="Rikki" LastName="Gunn" /> <Age>21</Age> <Year>Junior</Year> <Address> <Street xmlns="https://www.mathworks.com">65 Decatur Lane</Street> <City>Trenton</City> <State>ME</State> </Address> <Major>Economics</Major> <Minor>Art History</Minor> </Student> </Students>
まず、detectImportOptions
を使用して XMLImportOptions
オブジェクトを作成し、XML ファイルの要素を検出します。Street
要素ノードの XPath 式として名前と値の引数 VariableSelectors
を指定して、道路名だけを table に読み取ります。名前と値の引数 RegisteredNamespaces
を設定して、既存の名前空間の URL にカスタムの名前空間接頭辞を登録します。
opts = detectImportOptions("students.xml",RegisteredNamespaces=["myPrefix","https://www.mathworks.com"], ... VariableSelectors="//myPrefix:Street");
次に、インポート オプション オブジェクトを指定して readtable
を使用し、指定した変数をインポートします。
T = readtable("students.xml",opts)
T=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 パス上のフォルダー | ファイル名を 例: | ||||||||
フォルダー内のファイル | ファイルが現在のフォルダーまたは MATLAB パス上のフォルダーにない場合は、 例: 例: | ||||||||
インターネット URL | ファイルをインターネットの Uniform Resource Locator (URL) として指定する場合、 例: | ||||||||
リモートの場所 | リモートの場所に保存されたファイルの場合、
リモートの場所に基づいて、
詳細については、リモート データの操作を参照してください。 例: |
filename
にファイル拡張子が含まれる場合、detectImportOptions
は拡張子からファイル形式を判別します。それ以外の場合は、'FileType'
の名前と値のペアを指定してファイルの種類を指定しなければなりません。
関数 detectImportOptions
は、.txt
、.dat
、.csv
、.xls
、.xlsb
、.xlsm
、.xlsx
、.xltm
、.xltx
、.ods
、.xml
、.docx
、.html
、.xhtml
、および .htm
の各ファイル拡張子をサポートしています。
メモ
ファイル拡張子 .xlsb
と .ods
は、Excel® for Windows® を備えたプラットフォームでのみサポートされます。
データ型: char
| string
名前と値の引数
引数のオプションのペアを Name1=Value1,...,NameN=ValueN
として指定します。ここで Name
は引数名で、Value
は対応する値です。名前と値の引数は他の引数の後になければなりませんが、ペアの順序は重要ではありません。
R2021a より前では、コンマを使用してそれぞれの名前と値を区切り、Name
を引用符で囲みます。
例: 'FileType','spreadsheet'
FileType
— ファイルの種類
'spreadsheet'
| 'text'
| 'delimitedtext'
| 'fixedwidth'
| 'xml'
| 'worddocument'
| 'html'
ファイルの種類。'FileType'
と次の値のいずれかで構成されるコンマ区切りのペアとして指定します。
値 | ファイルのインポート オプション |
---|---|
'spreadsheet' |
|
'text' | テキスト ファイルのレイアウトにより、 |
'delimitedtext' |
|
'fixedwidth' |
|
'xml' |
|
'worddocument' |
|
'html' |
|
filename
にファイル拡張子が含まれない場合、または次の拡張子以外の場合は、名前と値のペアの引数 'FileType'
を使用します。
テキスト ファイルの場合、
.txt
、.dat
または.csv
スプレッドシート ファイルの場合、
.xls
、.xlsb
、.xlsm
、.xlsx
、.xltm
,.xltx
または.ods
XML ファイルの場合、
.xml
Microsoft Word ドキュメント ファイルの場合、
.docx
HTML ファイルの場合、
.html
、.xhtml
または.htm
ファイル拡張子 .xlsb
と .ods
は、Excel for Windows を備えたプラットフォームでのみサポートされます。
例: 'FileType','text'
データ型: char
| string
TextType
— インポートされるテキスト データの型
"string"
| "char"
インポートされるテキスト データの型。次のいずれかの値として指定します。
"string"
— テキスト データを string 配列としてインポートします。"char"
— テキスト データを文字ベクトルとしてインポートします。
例: "TextType","char"
DatetimeType
— インポートされる日付と時刻のデータの型
"datetime"
(既定値) | "text"
| "exceldatenum"
(スプレッドシート ファイルのみ)
インポートされる日付と時刻のデータの型。次のいずれかの値として指定します。
値 | 説明 |
---|---|
"datetime" | MATLAB の 詳細については、 |
"text" |
|
"exceldatenum" | Excel のシリアル日付値 値 |
ReadVariableNames
— 最初の行を変数名として読み取る
true
| false
最初の行を変数名として読み取るかどうかを示すインジケーター。'ReadVariableNames'
と、true
または false
で構成されるコンマ区切りのペアとして指定します。指定しない場合、readtable
は変数名の有無を自動的に検出します。
インジケーター | 説明 |
---|---|
| 読み取る領域の最初の行にテーブルの変数名が含まれている場合に使用します。 |
| 読み取る領域の最初の行にテーブルのデータが含まれている場合に使用します。 |
指定なし | 指定しない場合、インポート関数は true または false を自動的に検出し、それに応じて続行します。 |
データ型: logical
VariableNamingRule
— 変数名を保持するかどうかのフラグ
"modify"
(既定値) | "preserve"
変数名を保持するかどうかのフラグ。"modify"
または "preserve"
として指定します。
"modify"
— 無効な変数名 (関数isvarname
で判定) を、有効な MATLAB 識別子に変換。"preserve"
— スペースや非 ASCII 文字を含む変数名など、有効な MATLAB 識別子ではない変数名を保持。
R2019b 以降、変数名と行名には、スペースや非 ASCII 文字など任意の文字を含めることができます。また、英字だけでなく任意の文字で始めることができます。変数名と行名は、有効な MATLAB 識別子 (関数 isvarname
で判定) である必要はありません。これらの変数名と行名を保持するには、VariableNamingRule
の値を "preserve"
に設定します。VariableNamingRule
の値を "modify"
から "preserve"
に変更すると、変数名が更新されなくなります。
データ型: char
| string
ReadRowNames
— 最初の列を行名として読み取るかどうかを示すインジケーター
false
(既定値) | true
最初の列を行名として読み取るかどうかを示すインジケーター。'ReadRowNames'
と、false
または true
で構成されるコンマ区切りのペアとして指定します。
インジケーター | 説明 |
---|---|
| 読み取る領域の最初の列にテーブルの行名ではなくデータが含まれている場合に使用します。 |
| 読み取る領域の最初の列にテーブルの行名が含まれている場合に使用します。 |
指定なし | 指定のない場合、インポート関数は false と見なします。 |
データ型: logical
MissingRule
— 欠損データを管理する方法
'fill'
(既定値) | 'error'
| 'omitrow'
| 'omitvar'
欠損データを管理する方法。次の表のいずれかの値として指定します。
欠損ルール | 動作 |
---|---|
'fill' | 欠損データを
|
'error' | インポートを停止し、欠損しているレコードとフィールドを示すエラー メッセージを表示します。 |
'omitrow' | 欠損データを含む行を除外します。 |
'omitvar' | 欠損データを含む変数を除外します。 |
例: opts.MissingRule = 'omitrow';
データ型: char
| string
ImportErrorRule
— インポート エラーを処理する方法
'fill'
(既定値) | 'error'
| 'omitrow'
| 'omitvar'
インポート エラーを処理する方法。次の表のいずれかの値として指定します。
インポート エラー ルール | 動作 |
---|---|
'fill' | エラーが発生したデータを
|
'error' | インポートを停止し、エラーの原因となるレコードとフィールドを示すエラー メッセージを表示します。 |
'omitrow' | エラーが発生した行を除外します。 |
'omitvar' | エラーが発生した変数を除外します。 |
例: opts.ImportErrorRule = 'omitvar';
データ型: char
| string
WebOptions
— HTTP
または HTTPS
要求オプション
weboptions
オブジェクト
HTTP
または HTTPS
要求オプション。weboptions
オブジェクトとして指定します。weboptions
オブジェクトは、指定した filename
がプロトコル タイプ "http://"
または "https://"
を含むインターネット URL である場合にデータをインポートする方式を決定します。
ExpectedNumVariables
— 必要な変数の数
正の整数
必要な変数の数。'ExpectedNumVariables'
と正の整数で構成されるコンマ区切りのペアとして指定します。指定しない場合、変数の数はインポート関数により自動検出されます。
データ型: single
| double
NumHeaderLines
— ヘッダーの行数
正の整数
ファイルのヘッダーの行数。'NumHeaderLines'
と正の整数で構成されるコンマ区切りのペアとして指定します。指定しない場合、ファイル ヘッダーの行数はインポート関数により自動検出されます。
例: 'NumHeaderLines',7
データ型: single
| double
Range
— 読み取るデータの部分
文字ベクトル | string スカラー | 数値ベクトル
テキストまたはスプレッドシート ファイルから読み取るデータの部分。'Range'
と、次のいずれかの形式をとる文字ベクトル、string スカラー、または数値ベクトルで構成されるコンマ区切りのペアとして指定します。
Range の指定方法 | 説明 |
---|---|
開始セル
| 文字ベクトル、string スカラー、または 2 要素数値ベクトルとして、データの開始セルを指定します。
開始セルを使用して、インポート関数は、インポートを開始セルで開始し、最後の空の行またはフッター範囲で終了することで、データの範囲を自動的に検出します。 例: |
四角形の範囲
| 次の四角形の範囲フォームのいずれかを使用して、読み取る範囲を正確に指定します。
インポート関数は、指定された範囲内に含まれるデータのみを読み取ります。指定された範囲内の空のフィールドは欠損セルとしてインポートされます。 |
行範囲または列範囲
| Excel の行番号を使用して、開始行と終了行を示して範囲を指定します。 インポート関数は、指定された行範囲を使用して、最初の空でない列からデータの最後まで読み取ることにより、列の範囲を自動的に検出し、列ごとに 1 つの変数を作成します。 例: あるいは、Excel の列の文字または数字を使用して開始列と終了列を示して、範囲を指定します。 インポート関数は、指定された列範囲を使用して、最初の空でない行からデータの最後またはフッター範囲まで読み取ることにより、行の範囲を自動的に検出します。 指定された範囲の列数は 例: |
開始行番号
| 正のスカラー行インデックスを使用して、データを含む最初の行を指定します。 インポート関数は、指定された行インデックスを使用して、指定された最初の行からデータの最後またはフッター範囲まで読み取ることにより、データの範囲を自動的に検出します。 例: |
Excel の名前付き範囲
| Excel では、スプレッドシート内の範囲を表す名前を作成できます。たとえば、スプレッドシートの四角形部分を選択して 例: |
指定なしまたは空
| 指定しない場合、使用範囲はインポート関数により自動検出されます。 例: メモ: "使用範囲" とは、スプレッドシート内で実際にデータが含まれている四角形部分を指します。インポート関数は、データを含まない先頭と末尾の行と列をすべてトリミングして、使用範囲を自動的に検出します。空白のみのテキストはデータと見なされ、使用範囲内に取得されます。 |
データ型: char
| string
| double
Sheet
— 読み取り元のシート
空の文字配列 ''
(既定値) | 文字ベクトル | string スカラー | 正のスカラー整数
読み取り元のシート。空の文字配列、シート名を含む文字ベクトルまたは string スカラー、あるいはシート インデックスを示す正の整数スカラーとして指定します。インポート関数は Sheet
プロパティに指定された値に基づいて、表に説明されているように動作します。
指定 | 動作 |
---|---|
'' (既定) | 1 番目のシートからデータをインポートします。 |
名前 | スプレッドシート ファイル内のシートの順序に関係なく、一致する名前のシートからデータをインポートします。 |
整数 | スプレッドシート ファイル内のシート名に関係なく、整数で示された位置にあるシートからデータをインポートします。 |
データ型: char
| string
| single
| double
DataRange
— データの場所
文字ベクトル | string スカラー | 正のスカラー整数 | 正のスカラー整数の配列 | 文字ベクトルの cell 配列 | string 配列
インポートするデータの場所。文字ベクトル、string スカラー、文字ベクトルの cell 配列、string 配列、正のスカラー整数、または N
行 2
列の正のスカラー整数の配列として指定します。これらの形式の 1 つを使用して DataRange
を指定します。
指定方法 | 動作 |
---|---|
開始するセルまたは開始する行 | Excel の 開始セルを使用して、インポート関数は、インポートを開始セルで開始し、最後の空の行またはフッター範囲で終了することで、データの範囲を自動的に検出します。 あるいは、正のスカラー行インデックスを使用して、データを含む最初の行を指定します。 インポート関数は、指定された行インデックスを使用して、指定された最初の行からデータの最後またはフッター範囲まで読み取ることにより、データの範囲を自動的に検出します。 例: |
四角形の範囲 | 四角形の範囲フォームを使用して読み取る範囲を正確に指定します。 インポート関数は、指定された範囲内に含まれるデータのみを読み取ります。指定された範囲内の空のフィールドは欠損セルとしてインポートされます。 列数は 例: |
行範囲または列範囲 | Excel の行番号を使用して、開始行と終了行を示して範囲を指定します。 インポート関数は、指定された行範囲を使用して、最初の空でない列からデータの最後まで読み取ることにより、列の範囲を自動的に検出し、列ごとに 1 つの変数を作成します。 例: あるいは、Excel の列の文字または数字を使用して開始列と終了列を示して、範囲を指定します。 インポート関数は、指定された列範囲を使用して、最初の空でない行からデータの最後またはフッター範囲まで読み取ることにより、行の範囲を自動的に検出します。 指定された範囲の列数は 例: |
複数の行範囲 | "複数の行範囲" を指定して、 有効な複数の行範囲の配列は、次でなければなりません。
例: |
指定なしまたは空 | データを取得しません。 例: |
データ型: char
| string
| cell
| single
| double
RowNamesRange
— 行名の位置
文字ベクトル | string スカラー | 正のスカラー整数 | 空の文字配列 ''
行名の位置。文字ベクトル、string スカラー、正のスカラー整数または空の文字配列として指定します。次の表のいずれかの値として RowNamesRange
を指定します。
指定方法 | 動作 |
---|---|
| Excel の インポート関数はデータ内の各変数の名前を識別します。 例: |
四角形の範囲 | 四角形の範囲フォームを使用して読み取る範囲を正確に指定します。
例: |
行範囲 | Excel の行番号を使用して、開始行と終了行を示して範囲を指定します。 行名は 1 列でなければなりません。 例: |
数値インデックス | 正のスカラー列インデックスを使用して、行名を含む列を指定します。 例: |
指定なしまたは空 | 行名がないことを示します。 例: |
データ型: char
| single
| double
VariableNamesRange
— 変数名の位置
文字ベクトル | string スカラー | 正のスカラー整数 | 空の文字配列 ''
変数名の位置。文字ベクトル、string スカラー、正のスカラー整数または空の文字配列として指定します。次の表のいずれかの値として VariableNamesRange
を指定します。
指定方法 | 動作 |
---|---|
| Excel の インポート関数は、データ内の各変数の名前を読み取ります。 例: |
四角形の範囲 | 四角形の範囲フォームを使用して読み取る範囲を正確に指定します。 列数は 例: |
行範囲 | Excel の行番号を使用して、開始行と終了行を示して範囲を指定します。 1 行でなければなりません。 例: |
数値インデックス | 正のスカラー行インデックスを使用して、変数名を含む行を指定します。 例: |
指定なしまたは空 | 変数名がないことを示します。 例: |
データ型: char
| single
| double
VariableUnitsRange
— 変数の単位の位置
文字ベクトル | string スカラー | 正のスカラー整数 | 空の文字配列 ''
変数の単位の位置。文字ベクトル、string スカラー、正のスカラー整数または空の文字配列として指定します。次の表のいずれかの値として VariableUnitsRange
を指定します。
指定方法 | 動作 |
---|---|
| Excel の インポート関数は、データ内の各変数の単位を読み取ります。 例: |
四角形の範囲 | 四角形の範囲フォームを使用して読み取る範囲を正確に指定します。 列数は 例: |
行範囲 | Excel の行番号を使用して、開始行と終了行を示して範囲を指定します。 1 行でなければなりません。 例: |
数値インデックス | 正のスカラー行インデックスを使用して、データ単位を含む行を指定します。 例: |
指定なしまたは空 | 変数の単位がないことを示します。 例: |
データ型: char
| string
| single
| double
VariableDescriptionsRange
— 変数の説明の位置
文字ベクトル | string スカラー | 空の文字配列 ''
変数の説明の位置。文字ベクトル、string スカラー、正のスカラー整数または空の文字配列として指定します。次の表のいずれかの値として VariableDescriptionRange
を指定します。
指定方法 | 動作 |
---|---|
| Excel の インポート関数は、データ内の各変数の説明を読み取ります。 例: |
四角形の範囲 | 四角形の範囲フォームを使用して読み取る範囲を正確に指定します。 列数は 例: |
行範囲 | Excel の行番号を使用して、開始行と終了行を示して範囲を指定します。 1 行でなければなりません。 例: |
数値インデックス | 正のスカラー行インデックスを使用して、説明を含む行を指定します。 例: |
指定なしまたは空 | 変数の説明がないことを示します。 例: |
データ型: char
| string
| single
| double
Delimiter
— フィールドの区切り記号
string 配列 | 文字ベクトル | 文字ベクトルの cell 配列
区切りテキスト ファイル内のフィールドの区切り記号。string 配列、文字ベクトル、または文字ベクトルの cell 配列として指定します。
例: "Delimiter","|"
例: "Delimiter",[";","*"]
LeadingDelimitersRule
— 先頭の区切り記号を管理する方法
"keep"
| "ignore"
| "error"
区切りテキスト ファイル内の先頭の区切り記号を管理する方法。次の表の値のいずれかとして指定します。
値 | 動作 |
---|---|
"keep" | 区切り記号を維持します。 |
"ignore" | 区切り記号を無視します。 |
"error" | エラーを返し、インポート操作をキャンセルします。 |
TrailingDelimitersRule
— 末尾の区切り記号を管理する方法
'keep'
| 'ignore'
| 'error'
区切りテキスト ファイル内の末尾の区切り記号を管理する方法。次の表の値のいずれかとして指定します。
先頭の区切り記号のルール | 動作 |
---|---|
'keep' | 区切り記号を維持します。 |
'ignore' | 区切り記号を無視します。 |
'error' | エラーを返し、インポート操作を中止します。 |
ConsecutiveDelimitersRule
— 連続する区切り記号を管理する方法
"split"
| "join"
| "error"
区切りテキスト ファイル内の連続する区切り記号を管理する方法。次の表の値のいずれかとして指定します。
値 | 動作 |
---|---|
"split" | 連続する区切り記号を複数のフィールドに分割します。 |
"join" | 複数の区切り記号を結合して 1 つの区切り記号にします。 |
"error" | エラーを返し、インポート操作をキャンセルします。 |
VariableWidths
— 変数のフィールド幅
正の整数値のベクトル
固定幅のテキスト ファイルにおける変数のフィールド幅。正の整数値のベクトルとして指定します。ベクトルの正の整数はそれぞれ、フィールド内で変数を構成する文字数に対応します。VariableWidths
プロパティには、VariableNames
プロパティに指定された各変数に対応するエントリが含まれます。
Whitespace
— 空白として扱う文字
文字ベクトル | string スカラー
空白として扱う文字。1 文字以上が含まれる文字ベクトルまたは string スカラーとして指定します。
例: 'Whitespace',' _'
例: 'Whitespace','?!.,'
LineEnding
— 行末の文字
["\n","\r","\r\n"]
(既定値) | string 配列 | 文字ベクトル | 文字ベクトルの cell 配列
行末の文字。string 配列、文字ベクトルまたは文字ベクトルの cell 配列として指定します。
例: "LineEnding","\n"
例: "LineEnding","\r\n"
例: "LineEnding",["\b",":"]
Encoding
— 文字エンコード スキーム
''
| 'UTF-8'
| 'system'
| 'ISO-8859-1'
| 'windows-1251'
| 'windows-1252'
| ...
ファイルに関連付けられた文字エンコード スキーム。'Encoding'
と 'system'
で構成されるコンマ区切りのペア、または標準の文字エンコード スキーム名として指定します。
エンコードを指定しない場合、関数は自動文字セット検出を使用して、ファイルの読み取り時にエンコードを判断します。
例: 'Encoding','system'
はシステムの既定のエンコードを使用します。
データ型: char
| string
CommentStyle
— コメントのスタイル
string 配列 | 文字ベクトル | 文字ベクトルの cell 配列
コメントのスタイル。string 配列、文字ベクトルまたは文字ベクトルの cell 配列として指定します。単一行および複数行のコメントでは、開始識別子は空白以外の最初の文字でなければなりません。単一行のコメントでは、単一の識別子を指定して、その識別子で開始している行をコメントとして扱います。複数行のコメントでは、開始識別子 (最初のもの) から終了識別子 (2 番目のもの) までの行がコメントとして扱われます。識別子の文字ベクトルを 2 つまで指定できます。
たとえば、空白以外の最初の文字としてパーセント記号に続く行を無視するには、CommentStyle
を "%"
に指定します。
例: "CommentStyle",["/*"]
例: "CommentStyle",["/*","*/"]
DurationType
— duration データの出力データ型
'duration'
(既定値) | 'text'
テキスト ファイルからの duration データの出力データ型。'DurationType'
と 'duration'
または 'text'
のいずれかで構成されるコンマ区切りのペアとして指定します。
値 | インポートされる duration データの型 |
---|---|
'duration' | MATLAB の 詳細については、 |
'text' |
|
データ型: char
| string
ExtraColumnsRule
— 余分な列を処理する方法
'addvars'
| 'ignore'
| 'wrap'
| 'error'
データ内の余分な列を処理する方法。次の表のいずれかの値として指定します。
余分な列のルール | 動作 |
---|---|
'addvars' | 余分な列をインポートするには、新しい変数を作成します。余分な列が |
'ignore' | データの余分な列を無視します。 |
'wrap' | データの余分な列を新しいレコードにラップします。このアクションで変数の数は変わりません。 |
'error' | エラー メッセージを表示し、インポート操作を中止します。 |
データ型: char
| string
TreatAsMissing
— 欠損データとして解釈するテキスト
文字ベクトル | string スカラー | 文字ベクトルの cell 配列 | string 配列
欠損データとして解釈するテキスト。文字ベクトル、string スカラー、文字ベクトルの cell 配列、または string 配列として指定します。
インポート関数は、欠損インスタンスを見つけると、MissingRule
プロパティ内の指定を使用して、適切なアクションを決定します。
例: 'TreatAsMissing',{'NA','TBD'}
は、インポート関数に NA
または TBD
のすべての出現を欠損フィールドとして処理するように指示します。
データ型: char
| string
| cell
DateLocale
— 日付を読み取るロケール
文字ベクトル | string スカラー
日付を読み取るロケール。'DateLocale'
と、
の形式の文字ベクトルまたは string スカラーで構成されるコンマ区切りのペアとして指定します。ここで、次のようになります。xx
_YY
YY
は国を表す大文字の ISO 3166-1 alpha-2 コードxx
は言語を表す小文字 2 文字の ISO 639-1 コード
次の表に一般的なロケールの値を示します。
ロケール | 言語 | 国 |
---|---|---|
'de_DE' | ドイツ語 | ドイツ |
'en_GB' | 英語 | 英国 |
'en_US' | 英語 | 米国 |
'es_ES' | スペイン語 | スペイン |
'fr_FR' | フランス語 | フランス |
'it_IT' | イタリア語 | イタリア |
'ja_JP' | 日本語 | 日本 |
'ko_KR' | 韓国語 | 韓国 |
'nl_NL' | オランダ語 | オランダ |
'zh_CN' | 簡体字中国語 | 中国 |
%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'
の値で指定されたデータ型に変換します。
| 出力テーブル変数のデータ型 |
---|---|
| 自動的に検出されるデータ型 |
| 変更されない入力テキスト |
| 8 ビット整数、符号付き |
| 16 ビット整数、符号付き |
| 32 ビット整数、符号付き |
| 64 ビット整数、符号付き |
| 8 ビット整数、符号なし |
| 16 ビット整数、符号なし |
| 32 ビット整数、符号なし |
| 64 ビット整数、符号なし |
例: 'HexType','uint16'
は、16 進数値を表すテキスト ('0xFF'
) を出力テーブルの符号なし 16 ビット整数 (255
など) に変換します。
データ型: char
| string
BinaryType
— バイナリ データの出力データ型
'auto'
(既定値) | 'text'
| 'int8'
| 'int16'
| ...
バイナリ データの出力データ型。'BinaryType'
と表にリストされているいずれかの値で構成されるコンマ区切りのペアとして指定します。
入力ファイルはバイナリ値をテキストで表します。接頭辞として 0b
または 0B
を使用し、数字として文字 0
と 1
を使用します。
インポート関数は、バイナリ値を 'BinaryType'
の値で指定されたデータ型に変換します。
| 出力テーブル変数のデータ型 |
---|---|
| 自動的に検出されるデータ型 |
| 変更されない入力テキスト |
| 8 ビット整数、符号付き |
| 16 ビット整数、符号付き |
| 32 ビット整数、符号付き |
| 64 ビット整数、符号付き |
| 8 ビット整数、符号なし |
| 16 ビット整数、符号なし |
| 32 ビット整数、符号なし |
| 64 ビット整数、符号なし |
例: 'BinaryType','uint16'
は、バイナリ値を表すテキスト ('0b11111111'
など) を出力テーブルの符号なし 16 ビット整数 (255
など) に変換します。
データ型: char
| string
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'
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 の変数ヘッダーの下に繰り返しノード用の列を追加します。 |
'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"]
TableIndex
— 読み取るテーブルのインデックス
1
(既定値) | 正の整数
複数のテーブルを含む Microsoft Word ドキュメント ファイルまたは HTML ファイルから読み取るテーブルのインデックス。正の整数として指定します。
TableIndex
を指定すると、TableSelector
が等価の XPath 式に自動的に設定されます。
データ型: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
MergedCellColumnRule
— 列がマージされたセルの処理方法
"placeleft"
(既定値) | "placeright"
| "duplicate"
| "omitrow"
| "error"
列がマージされたセルの処理方法。次の表のいずれかの値として指定します。
インポート エラー ルール | 動作 |
---|---|
"placeleft" | 一番左のセルにデータを配置し、残りのセルは
|
"placeright" | 一番右のセルにデータを配置し、残りのセルは
|
"duplicate" | すべてのセルにデータを複製します。 |
"omitrow" | エラーが発生した行を除外します。 |
"error" | エラー メッセージを表示し、インポート操作を中止します。 |
MergedCellRowRule
— 行がマージされたセルの処理方法
"placeleft"
(既定値) | "placeright"
| "duplicate"
| "omitrow"
| "error"
行がマージされたセルの処理方法。次の表のいずれかの値として指定します。
インポート エラー ルール | 動作 |
---|---|
"placetop" | 一番上のセルにデータを配置し、残りのセルは
|
"placebottom" | 一番下のセルにデータを配置し、残りのセルは
|
"duplicate" | すべてのセルにデータを複製します。 |
"omitvar" | 行がマージされた変数を除外します。 |
"error" | エラー メッセージを表示し、インポート操作を中止します。 |
VariableNamesRow
— 変数の名前を含む行
非負の整数
変数の名前を含む行。非負の整数として指定します。
VariableNamesRow
を指定しない場合、ReadVariableNames
引数に従って変数の名前が読み取られます。VariableNamesRow
が0
の場合、変数の名前はインポートされません。それ以外の場合、指定した行から変数の名前がインポートされます。
データ型: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
VariableUnitsRow
— 変数の単位を含む行
0
(既定値) | 非負の整数
変数の単位を含む行。非負の整数として指定します。
VariableUnitsRow
が 0
の場合、変数の単位はインポートされません。それ以外の場合、指定した行から変数の単位がインポートされます。
データ型: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
VariableDescriptionsRow
— 変数の説明を含む行
0
(既定値) | 非負の整数
変数の説明を含む行。非負の整数として指定します。
VariableDescriptionsRow
が 0
の場合、変数の説明はインポートされません。それ以外の場合、指定した行から変数の説明がインポートされます。
データ型: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
EmptyRowRule
— テーブル内の空の行に適用するルール
"skip"
(既定値) | "read"
| "error"
テーブル内の空の行に適用するルール。次のいずれかとして指定します。
"skip"
– 空の行をスキップします。"read"
– 空の行を読み取ります。"error"
– テーブル検出時は空の行を無視し、読み取り時にエラーとして扱います。
EmptyColumnRule
— テーブル内の空の列に適用するルール
"skip"
(既定値) | "read"
| "error"
テーブル内の空の列に適用するルール。次のいずれかとして指定します。
"skip"
– 空の列をスキップします。"read"
– 空の列を読み取ります。"error"
– テーブル検出時は空の列を無視し、読み取り時にエラーとして扱います。
TableSelector
— table データの XPath 式
文字ベクトル | string スカラー
table データの XPath 式。文字ベクトルまたは string スカラーとして指定します。読み取り関数は、これを使用して出力 table のデータを選択します。TableSelector
には有効な XPath Version 1.0 の式を指定しなければなりません。
例: 'TableSelector','/RootNode/ChildNode'
出力引数
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
オブジェクトを返します。
ヒント
インポート オプション オブジェクト作成後のプロパティ値の更新:
detectImportOptions
で作成されたインポート オプション オブジェクトのプロパティをドット表記を使用して更新することは推奨されません。ドット表記を使用してプロパティを設定すると、MATLAB はファイルのすべてのインポート オプションを再検出するわけではありません。したがって、すべてのプロパティを更新して再検出するには、名前と値の引数を使用して新しい値を指定しなければなりません。たとえば、次のようにして、ConsecutiveDelimitersRule
プロパティの値を更新してインポート オプションを再検出します。opts = detectImportOptions(__,'ConsecutiveDelimitersRule','join')
インポートする XML 入力文書の要素を指定するには、XPath セレクターを使用します。たとえば、次の構造の XML ファイル
myFile.xml
をインポートするとします。次の表に、<data> <table category="ones"> <var>1</var> <var>2</var> </table> <table category="tens"> <var>10</var> <var>20</var> </table> </data>
VariableSelectors
やTableSelector
などの XPath セレクターの名前と値の引数でサポートされる XPath 構文を示します。選択操作 構文 例 結果 文書内の場所に関係なく、選択するノードに名前が一致するすべてのノードを選択する。 名前の前にスラッシュを 2 つ ( //
) 付ける。data = readtable('myFile.xml', 'VariableSelectors', '//var')
data = 4×1 table var ___ 1 2 10 20
要素ノードに属する属性の値を読み取る。 属性の前にアット マーク ( @
) を付ける。data = readtable('myFile.xml', 'VariableSelectors', '//table/@category')
data = 2×1 table categoryAttribute _________________ "ones" "tens"
一連のノードから特定のノードを選択する。 選択するノードのインデックスを大かっこ ( []
) で囲んで指定する。data = readtable('myFile.xml', 'TableSelector', '//table[1]')
data = 2×1 table var ___ 1 2
演算の優先順位を指定する。 最初に評価する式を小かっこで囲む。 data = readtable('myFile.xml', 'VariableSelectors', '//table/var[1]')
data = 2×1 table var ___ 1 10
data = readtable('myFile.xml', 'VariableSelectors', '(//table/var)[1]')
data = table var ___ 1
バージョン履歴
R2016b で導入
MATLAB コマンド
次の MATLAB コマンドに対応するリンクがクリックされました。
コマンドを MATLAB コマンド ウィンドウに入力して実行してください。Web ブラウザーは MATLAB コマンドをサポートしていません。
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)