主要内容

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

readtable

ファ▪▪ルからのテ▪▪ブルの作成

説明

T= readtable (文件名は,ファ,ルから列デ,タを読み取ることによって表を作成します。

readtableは,ファaaplル拡張子からファaaplル形式を判定します。

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

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

readtableは,ファ▪▪▪ルの列ごとに1▪▪▪の変数をTに作成し,ファ。既定では,readtable

T= readtable (文件名选择は,选择を使用して表を作成します。

T= readtable (___名称,值は1つ以上の名前と値のペアの引数で指定された追加のオプションを使用して,ファイルから表を作成します。たとえば,readtableでファ▪▪ルの最初の行を変数名として読み取るかデ▪▪タとして読み取るかを指定することができます。

デタ特有のンポトオプションを設定するには,选择オブジェクトを使用するか,名前と値のペアを指定できます。选择に加えて名前と値のペアを指定する場合,readtableがサポ,トするのは次の名前と値のペアのみです。

  • テキストおよびスプレッドシトのパラメタ- .ReadVariableNamesReadRowNames

  • テキストのみのパラメタ-DateLocale编码

  • スプレッドシトのみのパラメタ- .UseExcel

すべて折りたたむ

myCsvTable.datファルをテキストエディタに読み込み,その内容をプレビュします。スクリ,ンショットを以下に示します。このファ▪▪ルにはコンマ区切り列デ▪▪タが含まれています。

文件名=“myCsvTable.dat”

コンマ区切りのテキストファ▪▪ルからテ▪▪ブルを作成します。作成された表Tにはファルの列ごとに1の変数が含まれ,readtableはファ@ @ルの最初の行のエントリを変数名として扱います。

T = readtable(文件名)
T =5×6表LastName性别年龄身高体重吸烟者  ____________ ______ ___ ______ ______ ______ {' 史密斯的}{“M”}38 71 176 1{“约翰逊”}{“M”}43 69 163 0{威廉姆斯的}{' F '} 38 64 131 0{“琼斯”}{' F '} 40 67 133 0{“棕色”}{' F '} 49 64 119 0

R2020a以降,関数readtableは,関数detectImportOptionsをファ▪▪ルで自動的に呼び出すかのように入力ファ▪▪ルを読み取ります。これはデ,タ型を検出し,余分なヘッダ,行を破棄し,欠損値を埋めることができます。

たとえば,ファheadersAndMissing.txtをテキストエディタ,でプレビュ,します。このファ@ @ルには列名が含まれる行があり,別の行にはヘッダ@ @が含まれます。前の行にはデ,タ値がありますが,最後の2行にはギャップがあります。

このファesc escルから表を作成します。関数readtableは,ヘッダ,を破棄します。また,適切な欠損値(数値変数にはの値,テキストには空の文字ベクトル)をギャップに埋めます。

T =可读的(“headersAndMissing.txt”
T =5×6表LastName性别年龄身高体重吸烟者  ___________ __________ ___ ______ ______ ______ {' 吴}{“M”}38 71 176 1{“约翰逊”}{“M”}43 69 163 0{桑切斯的}{' F '} 38 64 131 0{“棕色”}{' F '}南67 133 0{“皮卡”}{0 x0 char}南64 119 0

以前のリリ,スでの既定の動作に戻すには,名前と値のペアの引数“格式”、“汽车”を指定します。readtableは,ヘッダ,をデ,タとして読み取り,結果として,すべての表変数をテキストに変換します。

T =可读的(“headersAndMissing.txt”“格式”“汽车”
T =6×6表LastName性别年龄身高体重吸烟者  ___________ __________ __________ _______ _______ ___________ {' 字符串的}{'字符串'}{“int”}{“int”}{“int”}{“布尔”}{‘吴’}{“M”}{“38”}{71”}{176”}{1}{“约翰逊”}{“M”}{“43”}{69”}{163”}{' 0 '}{桑切斯的}{' F '}{“38”}{64”}{131”}{' 0 '}{“棕色”}{' F '} {0 x0 char}{67”}{133”}{' 0 '}{“皮卡”}{0 x0 char} {0 x0 char}{64”}{119”}{' 0 '}

詳細にいては,このペジの"互換性にいての考慮事項"節を参照してください。

ファereplicationルmySpaceDelimTable.txtをテキストエディタ,でプレビュ,します。スクリ,ンショットを以下に示します。このファルにはスペス区切り列デタが含まれています。

スペスで区切られたテキストファルから表を作成します。ファesc escルの最初の行に検出可能な列名が含まれていないため,関数readtableは,既定の変数名Var1からVar5を割り当てます。

T =可读的(“mySpaceDelimTable.txt”
T =3×5表Var1 Var2 Var3 Var4 Var5  _____ ____ ____ ______ _________ {' 45 45 M '}{“纽约”}{“真实”}{' F '} 41 32{“CA”}{“假”}{“M”}40 34{‘马’}{“假”}

myCsvTable.datファルをテキストエディタに読み込み,その内容をプレビュします。スクリ,ンショットを以下に示します。このファ▪▪ルにはコンマ区切り列デ▪▪タが含まれています。

文件名=“myCsvTable.dat”

コンマ区切りのテキストファ▪▪ルからテ▪▪ブルを作成します。最初の2の列を文字ベクトル,3番目の列をuint32,その次の2の列を倍精度浮動小数点数としてンポトします。最後の列のエントリを文字ベクトルとして▪▪ンポ▪▪トします。

T = readtable(文件名,“格式”' % s % s % u % f % f % s '
T =5×6表LastName性别年龄身高体重吸烟者  ____________ ______ ___ ______ ______ ______ {' 史密斯的}{“M”}38 71 176{' 1 '}{“约翰逊”}{“M”}43 69 163{' 0 '}{威廉姆斯的}{' F '} 38 64 131{' 0 '}{“琼斯”}{' F '} 40 67 133{' 0 '}{“棕色”}{' F '} 49 64 119 {' 0 '}

変換指定子は,文字ベクトルの单元格配列の場合は% sの場合は% fuint32の場合は% uです。

ファルからド語の日付を読み取り,英語の日付としてテブルに追加します。

ファereplicationルgerman_dates.txtをテキストエディタ,でプレビュ,します。スクリ,ンショットを以下に示します。値の最初の列にはドイツ語の日付が含まれ、2 番目と 3 番目の列は数値となっています。

readtableを使用してサンプルファ@ @ルを読み取ります。変換指定子は日付では% D,浮動小数点値では% fです。ファFileEncodingで指定します。日付の書式とロケ,ルは,名前と値のペアの引数DateLocaleで指定します。

T =可读的(“german_dates.txt”...“格式”'%{dd MMMM yyyy}D %f %f'...“FileEncoding”“iso - 8859 - 15”...“DateLocale”“de_DE”
T =3×3表Var1 Var2 Var3 ________________ _________ 2014年1月01日20.2 100.5 2014年2月01日21.6 102.7 2014年3月01日20.7 99.8

スプレッドシ,トから,最初の行に変数名,最初の列に行名が含まれるテ,ブルを作成します。

T =可读的(“patients.xls”“ReadRowNames”,真正的);

テブルの最初の5行と最初の4の変数を表示します。

T (1:5, 1:4)
ans =5×4表性别年龄位置高度  __________ ___ _____________________________ ______ 史密斯{‘男性’}38{县综合医院的}71年约翰逊43{‘男性’}{VA医院的}69年威廉姆斯{‘女性’}38{圣。玛丽医疗中心64琼斯{'女' 40 {'VA医院' 67布朗{'女' 49{'县总医院' 64

テ,ブルのDimensionNamesプロパティを表示します。

T.Properties.DimensionNames
ans =1 x2单元格{' LastName}{}“变量”

“姓”は,スプレッドシ,トの最初の行の最初の列にある名前です。

スプレッドシ,トpatients.xlsの指定した領域のデ,タを使用して表を作成します。角C2E6の間にある5行3列の四角形領域のデタを使用します。この領域の最初の行は変数名として使用しないでください。

T =可读的(“patients.xls”...“范围”“C2: E6”...“ReadVariableNames”假)
T = Var1 Var2 Var3 ____ ___________________________ ____ 38 '县总医院' 71 43 '退伍军人医院' 69 38 '圣玛丽医疗中心' 64 40 '退伍军人医院' 67 49 '县总医院' 64

Tには,既定の変数名が含まれます。

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

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(“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

スペース,非ASCII文字などの任意の文字を含む変数名を保持しながら,表形式データを読み取ることができます。まず,任意の変数名を含む表を作成し,その表をテキストファイルに書き込みます。次に,元の変数名を保持しながら表形式デ,タを読み戻します。

任意の変数名を含む表を作成し,その表形式デタをファル“sampletable.txt”に書き込みます。

姓氏= {“桑切斯”“约翰逊”“李”“Diaz”“棕色”};年龄= [38;43;38;40;49];吸烟者=逻辑([1;0;1;0;1]);varNames = {“姓”“年龄”“吸烟者(1或0)”};T = table(姓氏,年龄,吸烟者,“VariableNames”varNames)
T =5×3表姓名年龄吸烟者(1或0 ) ___________ ___ _______________ {' 桑切斯的38}真{“约翰逊”}43假{‘李’}38真{“Diaz”}40假{“棕色”}49真的
writetable (T)“sampletable.txt”

readtableを使用して,表形式デ,タを読み戻します。既定で,MATLAB®はスペースおよび非ASCII文字が含まれる変数名を,有効なMATLAB®識別子に変換します。たとえば,matlab®は変数名“姓”“姓”“吸烟者(1或0)”“Smoker_1or0_”に変換します。変数名を保持しながら表形式データを読み取るには、“VariableNamingRule”パラメ,タ,を保存に設定します。

T_preserve = readtable(“sampletable.txt”“VariableNamingRule”“保存”
T_preserve =5×3表姓名年龄吸烟者(1或0 ) ___________ ___ _______________ {' 桑切斯的}38 43 0 1{“约翰逊”}{‘李’}38 1{“Diaz”}40 0{“棕色”}49 1

16進数と2進数をファ▪▪▪▪▪ルから読み取り,それらを数値変数として表に格納できます。関数readtableは,16進数と2進数にそれぞれ0 x0 bの接頭辞が含まれている場合,16進数と2進数を自動的に読み取ります。数値は整数デ,タ型を使用して格納されます。また,このような数値に接頭辞がない場合,。

hexAndBinary.txtのファルをテキストエディタでプレビュします。このファイルには16進数と2進数に接頭辞が含まれている列がありますが,含まれていない列が1つあります。

readtableを使用してファ@ @ルを読み取ります。この関数は,0 x0 bの接頭辞を含む数値を検出し,それらを整数として格納します。3番目の列には接頭辞がないため,その値はテキストとして扱われます。

T =可读的(“hexAndBinary.txt”
T =3×4表Var1 Var2 Var3 Var4  _____ ____ ________ ___________ 255 255{‘C7F9}{‘Device1} 256年4{05男朋友'}{‘Device2} 43981 129{‘F00F} {' Device3 '}

T.Var1には8ビットより大きいストレ,ジを必要とする値があるため,関数readtableは、数値を異なる整数クラス(uint16uint8)に格納します。

类(T.Var1)
Ans = 'uint16'
类(T.Var2)
Ans = 'uint8'

16進数と2進数からインポートされた数値を格納するためのデータ型を指定するには,名前と値のペアの引数“HexType”および“BinaryType”を使用します。値を符号付き 32 ビット整数として格納します。

T =可读的(“hexAndBinary.txt”“HexType”“int32”“BinaryType”“int32”);类(T.Var1)
Ans = 'int32'
类(T.Var2)
Ans = 'int32'

インポートオプションを使用して接頭辞のない16進数と2進数を検出し,それらのためのストレージを指定します。hexAndBinary.txtの▪▪ンポ▪▪トオプションオブジェクトを作成します。

opts = detectImportOptions(“hexAndBinary.txt”
opts = DelimitedTextImportOptions带属性:格式属性:分隔符:{','}空白:'\b\t ' LineEnding: {'\n' '\r' '\r\n'} CommentStyle: {} ConsecutiveDelimitersRule: 'split' LeadingDelimitersRule: 'keep' TrailingDelimitersRule: 'ignore' EmptyLineRule: 'skip' Encoding: 'UTF-8'替换属性:MissingRule: 'fill' ImportErrorRule: 'fill' ExtraColumnsRule: 'addvars'变量导入属性:按名称设置类型setvartype VariableNames: {'Var1', 'Var2', 'Var3'…{'auto', 'auto', 'char'…SelectedVariableNames: {'Var1', 'Var2', 'Var3'…使用setvaropts/getvaropts VariableNamingRule: 'modify'位置属性:DataLines: [1 Inf] VariableNamesLine: 0 RowNamesColumn: 0 VariableUnitsLine: 0 VariableDescriptionsLine: 0要显示表格的预览,使用preview

接頭辞がない場合でも3番目の列を16進数値としてインポートする必要があることを指定するには,関数setvaroptsを使用して,表の3番目の変数の型を変更します。変数の型をint32に設定します。

选项= setvaropts(选项,3,“NumberSystem”十六进制的“类型”“int32”
opts = DelimitedTextImportOptions带属性:格式属性:分隔符:{','}空白:'\b\t ' LineEnding: {'\n' '\r' '\r\n'} CommentStyle: {} ConsecutiveDelimitersRule: 'split' LeadingDelimitersRule: 'keep' TrailingDelimitersRule: 'ignore' EmptyLineRule: 'skip' Encoding: 'UTF-8'替换属性:MissingRule: 'fill' ImportErrorRule: 'fill' ExtraColumnsRule: 'addvars'变量导入属性:按名称设置类型setvartype VariableNames: {'Var1', 'Var2', 'Var3'…变量类型:{'auto', 'auto', 'int32'…SelectedVariableNames: {'Var1', 'Var2', 'Var3'…使用setvaropts/getvaropts VariableNamingRule: 'modify'位置属性:DataLines: [1 Inf] VariableNamesLine: 0 RowNamesColumn: 0 VariableUnitsLine: 0 VariableDescriptionsLine: 0要显示表格的预览,使用preview

T =可读的(“hexAndBinary.txt”选择)
T =3×4表Var1 Var2 Var3 Var4 _________ _____ ___________ 255 255 51193 {'Device1'} 256 4 1471 {'Device2'} 43981 129 61455 {'Device3'}

入力引数

すべて折りたたむ

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

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

場所

形式

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

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

例:“myFile.txt”

フォルダ内のファル

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

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

例:“dataDir \ myFile.txt”

リモ,トの場所

リモトの場所に保存されたファルの場合,文件名は次の形式の统一资源定位符(URL)として指定されたファイルの絶対パスを含まなければなりません。

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 '

  • 文件名にファaapl . exe,にファaapl . exe,ト関数は拡張子からファaapl . exe。それ以外の場合は,名前と値のペアの引数“文件类型”を指定してファ@ @ルの種類を示さなければなりません。

  • 微软®Excel®ソフトウェアがWindows操作系统®システムで,インポート関数は,使用しているExcelのバージョンで認識されるすべてのExcelスプレッドシートファイル形式を読み取ります。

  • システムにExcel for Windowsがない場合,またはMATLAB在线™を使用している場合,UseExcelプロパティがに設定されている状態で動作し,.xls, .xlsx, .xlsm, .xltx和.xltmファ@ @ルのみを読み取ります。

  • 区切りテキストファe.c.ルの場合,e.c.ンポ,e.c.ト関数はファe.c.ル内の空のフィ,e.c.ルドを,(数値変数の場合)または空の文字ベクトル(テキスト変数の場合)のどらかに変換します。テキストファ@ @ルのすべての行には同じ数の区切り記号がなければなりません。@ @ @ @ @ @ @ @ @ @ @ @ @ @。

デ,タ型:字符|字符串

ファ@ @ル@ @ンポ@ @トオプション。関数detectImportOptionsによって作成されたSpreadsheetImportOptionsオブジェクト,DelimitedTextImportOptionsオブジェクトまたはFixedWidthImportOptionsオブジェクトとして指定します。选择オブジェクトにはデタンポトのプロセスを制御するプロパティが含まれています。各オブジェクトのプロパティの詳細にいては,該当するオブジェクトのペジを参照してください。

ファ@ @ルの種類 出力
スプレッドシトファル SpreadsheetImportOptionsオブジェクト
テキストファ@ @ル DelimitedTextImportOptionsオブジェクト
固定幅テキストファ@ @ル FixedWidthImportOptionsオブジェクト

名前と値のペアの引数

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

例:“ReadVariableNames”,假的は,ファ。

読み取り時は次のようになります。

  • テキストファ电子邮箱ルの場合,文件类型ReadVariableNamesReadRowNamesTreatAsEmptyDatetimeType分隔符HeaderLines格式EmptyValueMultipleDelimsAsOneCollectOutputCommentStyleExpCharsLineEndingDateLocale编码HexTypeおよびBinaryTypeのパラメ,タ,名のみが適用されます。

  • スプレッドシトファルの場合,文件类型ReadVariableNamesReadRowNamesTreatAsEmptyDatetimeType范围UseExcelおよびTextTypeのパラメ,タ,名のみが適用されます。

  • 选择▪▪▪ReadVariableNamesReadRowNamesDateLocale编码およびUseExcelのパラメ,タ,名のみが適用されます。

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

すべて折りたたむ

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

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

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

“文本”

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

“delimitedtext”

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

“fixedwidth”

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

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

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

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

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

デ,タ型:字符|字符串

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

ンジケタ

説明

真正的

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

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

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

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

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

  • ReadVariableNames真正的の場合,VariableNamesRangeまたはVariableNamesLineプロパティを使用して,指定されたファ。

  • ReadVariableNamesの場合,VariableNamesプロパティから変数名を読み取ります。

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

ンジケタ

説明

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

真正的

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

指定なし 指定されていない場合,readtableと仮定します。

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

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

  • ReadRowNames真正的の場合,RowNamesRangeまたはRowNameColumnプロパティを使用して,指定されたファ。

  • ReadRowNamesの場合,行名を。

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

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

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

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

デ,タ型:字符|字符串

“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を参照してください。

デ,タ型:字符|字符串

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

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

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

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

デ,タ型:字符|字符串

テキストファ@ @ルのみ

すべて折りたたむ

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

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

指定子

フィ,ルドの区切り記号

','

“逗号”

コンマ

' '

“空间”

スペス

' \ t '

“标签”

タブ

“;”

“半”

セミコロン

“|”

“酒吧”

縦棒

指定なし

指定されていない場合,readtableは区切り記号を自動的に検出します。

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

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

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

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

デ,タ型:|

ファ@ @ルの列の形式。“格式”と1文字ベクトルまたはstring,“汽车”で構成されるコンマ区切りのペアとして指定します。変換指定子は,関数textscanが受け入れる指定子と同じです。

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

  • 名前と値のペア“格式”を指定しない場合,関数readtableは、デ、タの、ンポ、トに関数detectImportOptionsの結果を使用したかのように動作します。この動作の結果の詳細にいては,互換性にいての考慮事項を参照してください。

  • “格式”、“汽车”を指定する場合,作成された変数は,デ,タに応じて配列,文字ベクトルの单元格配列,またはdatetime配列です。列全体が数値の場合,変数はとして▪▪ンポ▪▪トされます。列に数値ではない要素が含まれる場合,変数は文字ベクトルの细胞配列,または値が日付と時間を表す場合はdatetime配列として▪▪ンポ▪▪トされます。

デ,タ型:字符|字符串

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

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

例:“MultipleDelimsAsOne”,1

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

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

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

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

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

デ,タ型:字符|字符串

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

デ,タ型:字符|字符串

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

既定の行末シ,ケンスは\ nr \または\ r \ nのいずれかで,ファ。

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

例:‘LineEnding’,‘:’

デ,タ型:字符|字符串

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

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

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

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

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

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

例:“DateLocale”、“ja_JP”

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

ンポ,トオプションに加えて引数“编码”を指定した場合,関数readtable“编码”

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

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

デ,タ型:字符|字符串

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

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

MATLABの持续时间デタ型

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

“文本”

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

  • “TextType”“字符”の場合,ンポト関数はdurationタを文字ベクトルのcell配列として返します。

  • “TextType”“字符串”の場合,ンポト関数はdurationタをstringの配列として返します。

デ,タ型:字符|字符串

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など)に変換します。

デ,タ型:字符|字符串

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

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

デ,タ型:逻辑

スプレッドシトファルのみ

すべて折りたたむ

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

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

例:“表”2

例:“表”“MySheetName”

例:“表”“MySheetName”

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

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

范围の指定方法 説明

“细胞”または(行坳)

開始セル

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

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

  • 開始行と開始列を示す(行坳)形式の2要素数値ベクトル。

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

例:的A5または(5 - 1)

Corner1: Corner2

四角形の範囲

構文Corner1: Corner2を使用して範囲を指定します。Corner1Corner2は,領域を定義する2の対角です。たとえば,“D2: H4”は,ワ,クシ,ト上の2の角D2H4の間にある3行5列の四角形領域を表します。名前と値のペアの引数“范围”では大文字小文字は区別されず,Excel A1参照スタイル(Excelヘルプを参照)が使用されます。

例:“范围”、“Corner1: Corner2

''

指定なしまたは空

指定しない場合,readtableは使用範囲を自動的に検出します。

例:“范围”,“

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

第一行:Row2

行範囲

Excelの行指定子によって開始行と終了行を指定して,行の範囲を表すことができます。これにより,readtableは指定された行内で列の使用範囲を自動的に検出します。たとえば,readtableは範囲指定“1:7”を,1 ~ 7行目の使用範囲にあるすべての列を読み取る命令として解釈します。

例:“范围”、“1:7的

Column1: Column2

列範囲

Excelの列指定子を使用して開始列と終了列を指定することで,範囲を表すことができます。これにより,readtableは指定された列内で行の使用範囲を自動的に検出します。たとえば,readtableは範囲指定“答:F”を,a ~ f列の使用範囲にあるすべての行を読み取る命令として解釈します。

例:“范围”、“答:F '

NamedRange

Excelの名前付き範囲

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

例:“范围”、“myTable”

例:“范围”A1: F10的

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

デ,タ型:字符|字符串

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

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

  • 真正的——インポート関数は,ファイルを読み取るときにMicrosoft Excelのインスタンスを起動します。

  • ——インポート関数は,ファイルを読み取るときにMicrosoft Excelのインスタンスを起動しません。このモードで動作しているインポート関数の機能では,サポートするファイル形式および式やマクロなどの対話型機能が異なります。

UseExcel

真正的

サポトされているファル形式

.xls, .xlsx, .xlsm, .xltx, .xltm, .xlsb, .ods

.xls, .xlsx, .xlsm, .xltx, .xltm

式やマクロなどの対話型機能のサポ,ト

あり

なし

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

出力引数

すべて折りたたむ

テ,ブルとして返される出力テ,ブル。テブルには、説明、変数単位、変数名、行名などのメタデータを保存できます。詳細については、表格のプロパティの節を参照してください。

ヒント

  • XLSX形式の大きなファescルは読み取りに時間がかかることがあります。インポートとエクスポートのパフォーマンスを向上させるためには,XLSB形式を使用することが微软によって推奨されています。

互換性にいての考慮事項

すべて展開する

R2020aでの動作変更

R2013bで導入