主要内容

このペ,ジの翻訳は最新ではありません。ここをクリックして,英語の最新版を参照してください。

detectImportOptions

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

説明

选择= detectImportOptions (文件名は,ファル内のテブルを検索し,そのンポトオプションを返します。オプションオブジェクトを変更し,それをreadtableとともに使用して,matlab®がテブルデタをンポトする方法を制御できます。返されるオプションのタaapl . exeプは,ファaapl . exeル拡張子によって決まります。たとえば,文件名がスプレッドシトファルの場合,関数はSpreadsheetImportOptionsオブジェクトを返します。ただし,文件名がテキストファesc escルの場合,関数はDelimitedTextImportOptionsオブジェクトまたはFixedWidthImportOptionsオブジェクトを返し,文件名がXMLファ目录ルの場合,XMLImportOptionsオブジェクトを返します。

选择= detectImportOptions (文件名名称,值は,1以上の名称,值ペアの引数によって指定された追加パラメタを使用して,ファル内のテブルを検索します。

すべて折りたたむ

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

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

opts = detectImportOptions(“patients.xls”
替换属性:MissingRule: 'fill' ImportErrorRule: 'fill'变量导入属性:使用setvartype VariableNames:{'姓氏','性别','年龄'按名称设置类型…变量类型:{'char', 'char', 'double'…SelectedVariableNames:{'姓','性别','年龄'…使用setvaropts/getvaropts VariableOptions:显示所有10个VariableOptions访问VariableOptions子属性VariableNamingRule: 'modify' Range Properties: DataRange: 'A2' (Start Cell) VariableNamesRange: 'A1' RowNamesRange: " VariableUnitsRange: " VariableDescriptionsRange: "要显示表格的预览,请使用preview

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

选择。SelectedVariableNames = {“收缩”舒张压的};

readtableをオプションオブジェクトと共に使用して,指定した変数を。

T =可读的(“patients.xls”、选择);总结(T)
变量:收缩压:100x1 double值:Min 109中位数122最大138舒张压:100x1 double值:Min 68中位数81.5最大99

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

opts = detectImportOptions(“airlinesmall.csv”
opts = DelimitedTextImportOptions带属性:格式属性:分隔符:{','}空白:'\b\t ' LineEnding: {'\n' '\r' '\r\n'} CommentStyle: {} ConsecutiveDelimitersRule: 'split' LeadingDelimitersRule: 'keep' TrailingDelimitersRule: 'ignore' EmptyLineRule: 'skip' Encoding: 'ISO-8859-1'替换属性:MissingRule: 'fill' ImportErrorRule: 'fill' ExtraColumnsRule: 'addvars'变量导入属性:使用setvartype VariableNames按名称设置类型:{“年”、“月”、“月之日”……和26个}变量类型:{'double', 'double', 'double'…和26个}selectedvariablename:{'年','月','月日'…使用setvaropts/getvaropts VariableNamingRule: 'modify'位置属性:DataLines: [2 Inf] VariableNamesLine: 1 RowNamesColumn: 0 VariableUnitsLine: 0 VariableDescriptionsLine: 0要显示表的预览,使用preview

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

getvaropts(选择,{“TaxiIn”“TaxiOut”})
ans = 1x2 TextVariableImportOptions数组属性:名称类型FillValue TreatAsMissing QuoteRule Prefixes suffix EmptyFieldRule WhitespaceRule

変数TaxiInTaxiOutの型をに変更します。

选项= setvartype(选项,{“TaxiIn”“TaxiOut”},“双”);

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

选择。SelectedVariableNames = {“TaxiIn”“TaxiOut”};

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

T =可读的(“airlinesmall.csv”、选择);总结(T)
变量:TaxiIn: 123523x1 double值:Min 0 Median 5 Max 1451 NumMissing 37383 TaxiOut: 123523x1 double值:Min 0 Median 13 Max 755 NumMissing 37364

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

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

opts = detectImportOptions(“outages.csv”);

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

选择。SelectedVariableNames = {“地区”“原因”};T =可读的(“outages.csv”、选择);总结(T)
变量:区域:1468x1单元格字符向量数组原因:1468x1单元格字符向量数组

テキストデ,タを字符串デタ型としてンポトしてから,名前と値のペアTextTypeを指定して▪▪ンポ▪▪トオプションを作成します。

opts = detectImportOptions(“outages.csv”“TextType”“字符串”);

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

选择。SelectedVariableNames = {“地区”“原因”};T =可读的(“outages.csv”、选择);总结(T)
变量:区域:1468x1 string原因:1468x1 string

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

XMLファescルからXMLImportOptionsオブジェクトを作成します。“VariableSelectors”の値として要素ノ,ドのXPath式を指定し,接頭辞myPrefixノドに属するurlに登録します。

opts = detectImportOptions(“students.xml”“RegisteredNamespaces”, (“myPrefix”“//www.tatmou.com”),...“VariableSelectors”" / / myPrefix:街”
替换属性:MissingRule: "fill" ImportErrorRule: "fill" RepeatedNodeRule: "addcol"变量导入属性:按名称设置类型使用setvartype VariableNames: "Street" VariableTypes: "string" SelectedVariableNames: "Street" VariableOptions:显示所有1个VariableOptions访问VariableOptions子属性使用setvaropts/getvaropts VariableNamingRule: "preserve"位置属性:TableSelector:  RowSelector: variableelectors: "//myPrefix:Street" VariableUnitsSelector:  VariableDescriptionsSelector:  RowNamesSelector:  RegisteredNamespaces: ["myPrefix" "//www.tatmou.com/jp/"]

関数readtableをオプションオブジェクトと共に使用して,選択した変数を。

T2 =可读(“students.xml”选择)
T2 =7×1表街道___________________“春巷591号”“珍珠街4641号”“高地路30号”“摩尔大道3388号”“摩尔大道3388号”“安吉道22号”“迪凯特巷65号”

入力引数

すべて折りたたむ

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

ファ电子邮箱ルの場所によって,文件名は次のいずれかの形式をとります。

場所

形式

現在のフォルダ,またはmatlabパス上のフォルダ,

ファ@ @ル名を文件名で指定します。

例:“myFile.txt”

フォルダ内のファル

ファルが現在のフォルダまたはmatlabパス上のフォルダにない場合は,文件名に絶対パス名または相対パス名を指定します。

例:“C: \ myFolder \ myFile.xlsx”

例:“\ imgDir \ myFile.txt”

@ @ @ @ @ @ @ @

ファイルをインターネットの统一资源定位符(URL)として指定する場合,文件名には“http://”または“https://”のプロトコルタ@ @プが含まれていなければなりません。

例:“http://hostname/path_to_file/my_data.csv”

リモ,トの場所

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

scheme_name: / /path_to_file/my_file.ext

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

リモ,トの場所 scheme_name
Amazon S3™ s3
Windows Azure®Blob存储 wasbwasbs
HDFS™ hdfs

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

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

文件名にファ电子邮箱ル拡張子が含まれる場合,detectImportOptionsは拡張子からファ@ @ル形式を判別します。それ以外の場合は,“文件类型”の名前と値のペアを指定してファ@ @ルの種類を指定しなければなりません。

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

メモ

ファ@ @ル拡張子.xlsb。odsは,Excel®对于Windows®を備えたプラットフォ,ムでのみサポ,トされます。

デ,タ型:字符|字符串

名前と値のペアの引数

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

例:“文件类型”、“表格”
サポトされるすべてのファルの種類

すべて折りたたむ

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

ファ@ @ルの@ @ンポ@ @トオプション
“表格”

SpreadsheetImportOptionsオブジェクトを返します。

“文本”

テキストファ超市超市ルのレ超市超市アウトにより,DelimitedTextImportOptionsオブジェクトまたはFixedWidthImportOptionsオブジェクトを返します。

“delimitedtext”

DelimitedTextImportOptionsオブジェクトを返します。このオプションは,列が区切り文字で区切られているテキストファ。

“fixedwidth”

FixedWidthImportOptionsオブジェクトを返します。このオプションは,固定幅の列をもテキストファルに使用します。

“xml”

XMLImportOptionsオブジェクトを返します。このオプションは,xmlファescルに使用します。

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

  • テキストファ电子邮箱ルの場合,. txt.datまたは. csv

  • スプレッドシトファルの場合,xls.xlsb.xlsm.xlsx.xltm.xltxまたは。ods

  • XMLファ电子邮箱ルの場合,. xml

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

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

デ,タ型:字符|字符串

“TextType”“字符”または“字符串”で構成されるコンマ区切りのペアとして指定します。

  • “字符”-テキストデタを文字ベクトルとしてmatlabにンポトします。

  • “字符串”-テキストデタをstring配列としてMATLABにンポトします。

例:“TextType”、“生物炭”

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

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

MATLABのdatetimeデタ型

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

“文本”

“DatetimeType”“文本”として指定した場合,“TextType”パラメ,タ,で指定された値によって決まります。

  • “TextType”“字符”に設定されている場合,cell配列として返します。

  • “TextType”“字符串”に設定されている場合,stringの配列として返します。

“exceldatenum”

Excelのシリアル日付値

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

デ,タ型:字符|字符串

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

ンジケタ

説明

真正的

読み取る領域の最初の行にテ,ブルの変数名が含まれている場合に使用します。readtableは,検出した変数名を使用してTの各列に変数を作成します。

読み取る領域の最初の行にテ,ブルのデ,タが含まれている場合に使用します。readtableは,“Var1”,…,“VarN”の形式で既定の変数名を作成します。ここで,Nは変数の数です。

指定なし 指定しない場合,真正的またはを自動的に検出し,それに応じて続行します。

デ,タ型:逻辑

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

  • “修改”-無効な変数名(関数isvarnameで判定)を,有効なmatlab識別子に変換。

  • “保存”——スペースや非ASCII文字を含む変数名など,有効なMATLAB識別子ではない変数名を保持。

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

デ,タ型:字符|字符串

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

ンジケタ

説明

読み取る領域の最初の列にテ,ブルの行名ではなくデ,タが含まれている場合に使用します。

真正的

読み取る領域の最初の列にテ,ブルの行名が含まれている場合に使用します。

指定なし 指定のない場合,と見なします。

デ,タ型:逻辑

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

欠損ル,ル 動作
“填满”

欠損デ,タをFillValueプロパティの内容に置き換えます。

FillValueプロパティは,VariableImportOptionsオブジェクトで指定されます。FillValueプロパティへのアクセスの詳細にいては,getvaroptsを参照してください。

“错误”
“omitrow” 欠損デ,タを含む行を除外します。
“omitvar” 欠損デ,タを含む変数を除外します。

例:选择。MissingRule = 'omitrow';

デ,タ型:字符|字符串

。次の表のいずれかの値として指定します。

インポートエラールール 動作
“填满”

エラ,が発生したデ,タをFillValueプロパティの内容に置き換えます。

FillValueプロパティは,VariableImportOptionsオブジェクトで指定されます。FillValueプロパティへのアクセスの詳細にいては,getvaroptsを参照してください。

“错误” ジを表示します。
“omitrow” エラ,が発生した行を除外します。
“omitvar” エラ,が発生した変数を除外します。

例:选择。ImportErrorRule = 'omitvar';

デ,タ型:字符|字符串

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

すべて折りたたむ

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

デ,タ型:|

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

例:“NumHeaderLines”7

デ,タ型:|

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

范围の指定方法 説明

開始セル

“细胞”または(行坳)

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

  • ExcelのA1表記法を使用した列の文字および行番号を含む文字ベクトルまたは字符串スカラ。たとえば,A5は列一个と行5が交わる場所にあるセルの識別子です。

  • 開始行と開始列を示す(行坳)形式の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]のようになります。

。指定された範囲内の空のフィルドは欠損セルとしてンポトされます。

行範囲または列範囲

“第一行:Row2”または“Column1: Column2”

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

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

例:“5:500”

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

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

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

例:“答:K”

開始行番号

n

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

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

例:5

Excelの名前付き範囲

“NamedRange”

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

例:“范围”、“myTable”

指定なしまたは空

指定しない場合,使用範囲は。

例:“范围”,“

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

デ,タ型:字符|字符串|

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

すべて折りたたむ

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

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

デ,タ型:字符|字符串||

。文字ベクトル、字符串スカラ、文字ベクトルのcell配列、字符串配列、正のスカラ,整数,またはN2列の正のスカラ,整数の配列として指定します。これらの形式の1を使用してDataRangeを指定します。

指定方法 動作

“细胞”またはn

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

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

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

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

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

例:的A5または5

Corner1: Corner2

四角形の範囲

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

。指定された範囲内の空のフィルドは欠損セルとしてンポトされます。

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

例:“A5: K50”

第一行:Row2またはColumn1: Column2

行範囲または列範囲

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

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

例:“5:500”

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

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

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

例:“答:K”

(n1 n2;n3陶瓷;……)

複数の行範囲

“複数の行範囲”を指定して,Nの異なる行範囲を含むN2列の配列で読み取ります。

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

  • 行の範囲は昇順で指定する。すなわ,配列で指定された最初の行範囲は,他の行範囲より,ファル内で先に出現する。

  • オ,バ,ラップしない行範囲のみを含む。

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

例:[1 3;5 6;8正)

指定なしまたは空

デ,タを取得しません。

例:

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

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

指定方法 動作

“细胞”

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

例:的A5

Corner1: Corner2

四角形の範囲

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

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

例:“A5: A50”

第一行:Row2

行範囲

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

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

例:“25”

n

数値@ @ンデックス

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

例:5

指定なしまたは空

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

例:

デ,タ型:字符||

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

指定方法 動作

“细胞”

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

例:的A5

Corner1: Corner2

四角形の範囲

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

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

例:“A5: K5”

第一行:Row2

行範囲

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

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

例:“5”

n

数値@ @ンデックス

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

例:5

指定なしまたは空

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

例:

デ,タ型:字符||

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

指定方法 動作

“细胞”

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

例:的A5

Corner1: Corner2

四角形の範囲

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

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

例:“A5: K5”

第一行:Row2

行範囲

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

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

例:“5”

n

数値@ @ンデックス

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

例:5

指定なしまたは空

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

例:

デ,タ型:字符|字符串||

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

指定方法 動作

“细胞”

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

例:的A5

Corner1: Corner2

四角形の範囲

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

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

例:“A5: K5”

第一行:Row2

行範囲

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

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

例:“5”

n

数値@ @ンデックス

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

例:5

指定なしまたは空

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

例:

デ,タ型:字符|字符串||

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

すべて折りたたむ

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

例:“分隔符”,“|”

例:“分隔符 ',{';','*'}

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

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

先頭の区切り記号のル,ル 動作
“保持” 区切り記号を維持します。
“忽略” 区切り記号を無視します。
“错误” エラ,を返し;

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

先頭の区切り記号のル,ル 動作
“保持” 区切り記号を維持します。
“忽略” 区切り記号を無視します。
“错误” エラ,を返し;

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

連続する区切り記号のル,ル 動作
“分裂” 連続する区切り記号を複数のフィ,ルドに分割します。
“加入” 複数の区切り記号を結合して1の区切り記号にします。
“错误” エラ,を返し;

デ,タ型:字符|字符串

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

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

例:“空白”、“_”

例:“空白”、“? !”

行末の文字。文字ベクトル,弦スカラー,文字ベクトルの细胞配列,または字符串配列として指定します。

例:' LineEnding ', ' \ n '

例:“LineEnding”、“\ r \ n”

例:LineEnding,{‘\ b’,‘:’}

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

ファルに関連付けられた文字エンコドスキム。“编码”“系统”で構成されるコンマ区切りのペア,または標準の文字エンコ,ドスキ,ム名として指定します。

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

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

デ,タ型:字符|字符串

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

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

例:CommentStyle,{“/ *”}

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

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

インポートされる时间データの型
“持续时间”

MATLABの持续时间デタ型

詳細にいては,持续时间を参照してください。

“文本”

“DurationType”“文本”として指定した場合,“TextType”パラメ,タ,で指定された値によって決まります。

  • “TextType”“字符”に設定されている場合,インポート関数は时间データを文字ベクトルの细胞配列として返します。

  • “TextType”“字符串”に設定されている場合,インポート関数は时间データを字符串の配列として返します。

デ,タ型:字符|字符串

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

余分な列のル,ル 動作
“addvars”

余分な列を。余分な列がN列ある場合,新しい変数を“ExtraVar1”、“ExtraVar2’,……、“ExtraVarN”として▪▪ンポ▪▪トします。

メモ:余分な列はデ,タ型が字符のテキストとして▪▪ンポ▪▪トされます。

“忽略” デ,タの余分な列を無視します。
“包装” デ,タの余分な列を新しいレコ,ドにラップします。このアクションで変数の数は変わりません。
“错误” エラメッセジを表示し,ンポト操作を中止します。

デ,タ型:字符|字符串

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

▪▪▪▪▪MissingRuleプロパティ内の指定を使用して,適切なアクションを決定します。

例:TreatAsMissing,{“NA”,“TBD”}は,NAまたはTBDのすべての出現を欠損フィ,ルドとして処理するように指示します。

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

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

  • YYは国を表す大文字のISO 3166-1 alpha-2コ,ド

  • xxは言語を表す小文字2文字のiso 639-1コ,ド

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

% D書式指定子を使用してテキストをdatetime値として読み取る場合,DateLocaleを使用して,。

ンポ,トオプション选择に加えて引数DateLocaleを指定した場合,DateLocale

例:“DateLocale”、“ja_JP”

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

デ,タ型:字符|字符串

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

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

デ,タ型:字符|字符串

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

デ,タ型:逻辑

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

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

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

“HexType”の値

出力テ,ブル変数のデ,タ型

“汽车”

自動的に検出されるデ,タ型

“文本”

変更されない入力テキスト

“int8”

8ビット整数,符号付き

“int16”

16ビット整数,符号付き

“int32”

32ビット整数,符号付き

“int64”

64ビット整数,符号付き

“uint8”

8ビット整数,符号なし

“uint16”

16ビット整数,符号なし

“uint32”

32ビット整数,符号なし

“uint64”

64ビット整数,符号なし

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

デ,タ型:字符|字符串

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

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

@ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @“BinaryType”の値で指定されたデ,タ型に変換します。

“BinaryType”の値

出力テ,ブル変数のデ,タ型

“汽车”

自動的に検出されるデ,タ型

“文本”

変更されない入力テキスト

“int8”

8ビット整数,符号付き

“int16”

16ビット整数,符号付き

“int32”

32ビット整数,符号付き

“int64”

64ビット整数,符号付き

“uint8”

8ビット整数,符号なし

“uint16”

16ビット整数,符号なし

“uint32”

32ビット整数,符号なし

“uint64”

64ビット整数,符号なし

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

デ,タ型:字符|字符串

XMLファescルのみ

すべて折りたたむ

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

例:“ImportAttributes”,假的

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

例:“AttributeSuffix”、“_att”

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

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

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

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

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

例:“TableNodeName”、“节点名的

tableデタの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”“忽略”,または“错误”として指定します。

繰り返しノ,ドの規則

動作

“addcol”

表の変数ヘッダ,の下に繰り返しノ,ド用の列を追加します。“RepeatedNodeRule”の値を“addcol”と指定しても,表に繰り返しノ,ドに対する別個の変数は作成されません。

“忽略”

繰り返しノドはスキップしてンポトします。

“错误” エラメッセジを表示し,ンポト操作を中止します。

例:“RepeatedNodeRule”、“忽略”

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

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

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

T = readtable("example.xml", "VariableSelector", "/myprefix:Data",…"RegisteredNamespaces", [" myprefix ", " //www.tatmou.com "])

例:“RegisteredNamespaces”,(“myprefix”、“//www.tatmou.com”)

出力引数

すべて折りたたむ

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

ヒント

  • :detecImportOptionsで作成されたインポートオプションオブジェクトのプロパティをドット表記を使用して更新することは推奨されません。ドット表記を使用してプロパティを設定すると,MATLABはファイルのすべてのインポートオプションを再検出するわけではありません。したがって,すべてのプロパティを更新して再検出するには,名前と値の引数を使用して新しい値を指定しなければなりません。たとえば,次のようにして,ConsecutiveDelimitersRuleプロパティの値を更新して▪▪ンポ▪▪トオプションを再検出します。

    opts = detectImportOptions(__,“ConsecutiveDelimitersRule”“加入”

  • RowSelectorVariableSelectorなどのXPathセレクタ,の名前と値の引数では,次のXPath構文がサポ,トされます。

    • ドキュメント内の場所に関係なく,選択するノ,ドに名前が一致するすべてのノ,ドを選択するには," / / myNode”構文を使用します。" / / myNode”を使用すると,XPath式の選択するノ,ドより前の部分を省略できます。

    • ファ▪▪ル内の1ChildNode [nを指定できます。ここで,nは,。たとえば,パス“/ RootNode / ChildNode[2]”は,親がRootNodeである2目のChildNode要素を選択します。

    • 入力XMLファイル内の,ある要素ノードに属する1つの属性の値を読み取るには,属性名の前に@を指定します。たとえば,“/ RootNode / ChildNode [2] / @AttributeName”は,親がRootNodeである2目のChildNode要素に属する属性AttributeNameを選択します。

R2016bで導入