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

文件名にファイル拡張子が含まれない場合,または次の拡張子以外の場合は,名前と値のペアの引数“文件类型”を使用します。

例:“文件类型”、“文本”

データ型:字符|字符串

最初の列を行名として読み取るかどうかを示すインジケーター。“ReadRowNames”と,假、真正的、0または1で構成されるコンマ区切りのペアとして指定します。

メモ:“ReadVariableNames”と“ReadRowNames”の両方の論理インジケーターが真正的の場合,readtableは領域の最初の行の最初の列にある名前をT.Properties.DimensionNamesプロパティの最初の次元の名前として読み取ります。

インポートオプションの选择に加えて引数ReadRowNamesを指定した場合,readtableの動作が指定に基づき変化します。

空の値として扱うプレースホルダーテキスト。“TreatAsMissing”と,文字ベクトル,文字ベクトルの细胞配列,字符串または字符串配列で構成されるコンマ区切りのペアとして指定します。これらの文字に対応する表要素は南に設定されます。

“TreatAsMissing”はファイル内の数値列にのみ適用され,readtableは“-99”のような数値リテラルを受け取りません。

例:“TreatAsMissing”、“N / A”または“TreatAsMissing”、“N / A”は数値列内のN/Aを南に設定します。

例:TreatAsMissing,{“。”,“NA”、“N / A”}または“TreatAsMissing”,(“。”,“NA”、“N / A”)は数値列内の。、NAおよびN/Aを南に設定します。

データ型:字符|字符串

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

例:“TextType”、“生物炭”

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

データ型:字符|字符串

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

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

データ型:字符|字符串

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

メモ:“ReadVariableNames”と“ReadRowNames”の両方の論理インジケーターが真正的の場合,readtableは領域の最初の行の最初の列にある名前をT.Properties.DimensionNamesプロパティの最初の次元の名前として読み取ります。

インポートオプションの选择に加えて引数ReadVariableNamesを指定した場合,readtableの動作が指定に基づき変化します。

フィールドの区切り記号。“分隔符”と文字ベクトル,文字ベクトルの细胞配列,または字符串で構成されるコンマ区切りのペアとして指定します。分隔符は,コンマ”、“やピリオド“。”などの有効な文字を使用して指定します。

次の表は,一般的に使用されるフィールドの区切り記号の一部を示しています。

連続する区切り記号を1つの区切り記号として扱うには,分隔符を文字ベクトルの细胞配列として指定します。さらに,MultipleDelimsAsOneオプションも指定しなければなりません。

例:“分隔符”、“,”または“分隔符”、“逗号”

データ型:字符|字符串|细胞

ファイルの先頭でスキップするヘッダーの行数。“NumHeaderLines”と正の整数で構成されるコンマ区切りのペアとして指定します。指定しない場合,readtableはスキップする行数を自動的に検出します。

データ型:单|双

ファイルの列の形式。“格式”と1つ以上の変換指定子をもつ文字ベクトルまたは字符串スカラー,または“汽车”で構成されるコンマ区切りのペアとして指定します。変換指定子は,関数textscanが受け入れる指定子と同じです。

形式を指定すると,大きなファイルの速度が大幅に高速化する場合があります。格式に値を指定しない場合,readtableは%问を使用して非数値の列を解釈します。%问指定子はテキストを読み取り,必要に応じて二重引用符(＂)を除外します。

データ型:字符|字符串

区切り付きテキストファイルの空の数値フィールドに返す値は,“EmptyValue”およびスカラーで構成されるコンマ区切りのペアとして指定します。

複数の区切り記号の取り扱いは,“MultipleDelimsAsOne”と真正的または假で構成されるコンマ区切りのペアとして指定します。真正的の場合,インポート関数は連続した区切り記号を1つの区切り記号として扱います。区切り記号が空白で分けられて繰り返された場合も,1つの区切り記号として扱われます。分隔符オプションも指定しなければなりません。

例:“MultipleDelimsAsOne”,1

データ連結を決定する論理インジケーターは,“CollectOutput”と,真正的または假とで構成されるコンマ区切りのペアとして指定します。真正的の場合,インポート関数は同じ基本MATLABクラスの連続する出力セルを連結して1つの配列にします。

無視するテキストを示す記号。“CommentStyle”と,文字ベクトル,文字ベクトルの细胞配列,字符串,または字符串配列で構成されるコンマ区切りのペアとして指定します。

たとえば,“%”などの文字を指定して,同じ行でその記号の後に続くテキストを無視します。{'/*','*/'}のように2つの文字ベクトルの细胞配列を指定して,それらのシーケンスの間にあるすべてのテキストを無視します。

MATLABは,各フィールドの最初にだけコメントをチェックします(フィールド内はコメントチェック対象外です)。

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

データ型:字符|字符串

指数文字。“ExpChars”と文字ベクトルまたは字符串で構成されるコンマ区切りのペアとして指定します。既定の指数文字はe、E、dおよびDです。

データ型:字符|字符串

行末の文字。“LineEnding”と文字ベクトルまたは字符串で構成されるコンマ区切りのペアとして指定します。文字ベクトルは“\ r \ n”であるか,単一の文字を指定しなければなりません。一般的な行末文字としては,改行文字(' \ n ')やキャリッジリターン(' \ r ')があります。“\ r \ n”を指定すると,インポート関数はr \、\ n2,そのつの組み合わせ(\ r \ n)をすべて行末文字として扱います。

既定の行末シーケンスは\ n、r \または\ r \ nのいずれかで,ファイルの内容によって異なります。

ファイルの最後の行の末尾に欠損値および行末シーケンスが存在する場合,インポート関数はそれらのフィールドに空の値を返します。これにより,出力电池配列C内の個々のセルが確実に同じサイズになります。

例:‘LineEnding’,‘:’

データ型:字符|字符串

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

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

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

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

例:“DateLocale”、“ja_JP”

ファイルに関連付けられた文字エンコードスキーム。“编码”と“系统”で構成されるコンマ区切りのペア,または標準の文字エンコードスキーム名として指定します。エンコードを指定しない場合,関数readtableは自動文字セット検出を使用して,ファイルの読み取り時にエンコードを判断します。

インポートオプションに加えて引数“编码”を指定した場合,関数readtableは“编码”で指定された値を使用して,インポートオプションで定義されたエンコードをオーバーライドします。

例:“编码”,“utf - 8”は,utf - 8をエンコードとして使用します。

例:“编码”、“系统”はシステムの既定のエンコードを使用します。

データ型:字符|字符串

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

データ型:字符|字符串

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

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

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

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

データ型:字符|字符串

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

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

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

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

データ型:字符|字符串

非数値文字を数値変数から削除します。逻辑真正的または假として指定します。

例:名前と値のペアが“TrimNonNumeric”,真的のように指定される場合,インポート関数は“500美元/ -”を500として読み取ります。

データ型:逻辑

読み取るワークシート。“表”と,ワークシートインデックスを示す正の整数またはワークシート名を含む文字ベクトルまたは字符串で構成されるコンマ区切りのペアとして指定します。ワークシート名にコロン(：)を含めることはできません。スプレッドシートファイルのシートの名前を調べるには、表= sheetnames(文件名)を使用します。詳細については,sheetnamesを参照してください。

インポートオプション选择に加えて引数表を指定した場合,関数readtableは引数表の指定された値を使用して,インポートオプションで定義されたシート名をオーバーライドします。

例:“表”，2

例:“表”，“MySheetName”

例:“表”，“MySheetName”

データ型:字符|字符串|单|双|int8|int16|int32|int64|uint8|uint16|uint32|uint64

ワークシートの読み取り対象部分。“范围”と次のいずれかの形式の文字ベクトルまたは字符串スカラーで構成されるコンマ区切りのペアで四角形の領域として指定します。

例:“范围”，A1: F10的

例:“范围”，“A1: F10”- - - - - -

データ型:字符|字符串

スプレッドシートデータを読み取るときに,Microsoft Excel对于Windowsのインスタンスを起動するためのフラグ。“UseExcel”と,真正的または假のいずれかで構成されるコンマ区切りのペアとして指定します。

“UseExcel”パラメーターは,次の値のいずれかに設定できます。

Windowsプラットフォームでスプレッドシートファイルを読み取るときにMicrosoft Excelのインスタンスを起動する場合は,“UseExcel”パラメーターを真正的に設定します。

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

例:“AttributeSuffix”、“_att”

属性のインポート。“ImportAttributes”と,1（真正的)または0（假)のいずれかで構成されるコンマ区切りのペアとして指定します。假を指定すると,読み取り関数は入力ファイル内のXML属性を出力表に変数としてインポートしません。

例:“ImportAttributes”,假的

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

例:“RowNodeName”、“XMLNodeName”

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

例:“RowSelector”、“RootNode / ChildNode”

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

例:VariableNodeNames,{‘XMLNodeName1’,‘XMLNodeName2}

例:“VariableNodeNames”、“XMLNodeName”

例:“VariableNodeNames”,(“XMLNodeName1”、“XMLNodeName2”)

表変数のXPath式。文字ベクトルの细胞配列または字符串配列として指定します。読み取り関数は,これを使用して表変数を選択します。VariableSelectorsには有効なXPath 1.0版本の式を指定しなければなりません。

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

例:‘VariableSelectors’,”/ RootNode / ChildNode”

例:“VariableSelectors”,(“/ RootNode / ChildNode1”,“/ RootNode / ChildNode2”)

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

例:“TableNodeName”、“节点名的

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

例:“TableSelector”、“RootNode / ChildNode”

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

例:“VariableUnitsSelector”、“RootNode / ChildNode”

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

例:“VariableDescriptionsSelector”、“RootNode / ChildNode”

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

例:“RowNamesSelector”、“RootNode / ChildNode”

表の特定の行における繰り返しXMLノードの処理方法。“addcol”、“忽略”,または“错误”として指定します。

例:“RepeatedNodeRule”、“忽略”

登録済みの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 ", " //www.tianjin-qmedu.com ")と指定して,接頭辞myprefixをURL//www.tianjin-qmedu.comに割り当てます。

T = readtable("example.xml"， " variableelector "， "/myprefix:Data"，…“RegisteredNamespaces”,[" myprefix ", " //www.tianjin-qmedu.com "])

例:“RegisteredNamespaces”,(“myprefix”、“//www.tianjin-qmedu.com”)