ドキュメンテ,ションヘルプセンタドキュメンテ,ション
detectImportOptions
このペ,ジの翻訳は最新ではありません。ここをクリックして,英語の最新版を参照してください。
ファ▪▪ルからのテ▪▪ブルの作成
T = readtable(文件名)
T = readtable(文件名,opts)
T =可读的(___、名称、值)
例
T= readtable (文件名)は,ファ,ルから列デ,タを読み取ることによって表を作成します。
T= readtable (文件名)
T
文件名
readtableは,ファaaplル拡張子からファaaplル形式を判定します。
readtable
区切りテキストファ电子邮箱ルの場合,. txt、.datまたは. csv
. txt
.dat
. csv
スプレッドシトファルの場合,xls、.xlsb、.xlsm、.xlsx、.xltm,.xltxまたは。ods
xls
.xlsb
.xlsm
.xlsx
.xltm
.xltx
。ods
readtableは,ファ▪▪▪ルの列ごとに1▪▪▪の変数をTに作成し,ファ。既定では,readtable。
T= readtable (文件名,选择)は,选择を使用して表を作成します。
T= readtable (文件名,选择)
选择
T= readtable (___,名称,值)は1つ以上の名前と値のペアの引数で指定された追加のオプションを使用して,ファイルから表を作成します。たとえば,readtableでファ▪▪ルの最初の行を変数名として読み取るかデ▪▪タとして読み取るかを指定することができます。
T= readtable (___,名称,值)
名称,值
デタ特有のンポトオプションを設定するには,选择オブジェクトを使用するか,名前と値のペアを指定できます。选择に加えて名前と値のペアを指定する場合,readtableがサポ,トするのは次の名前と値のペアのみです。
テキストおよびスプレッドシトのパラメタ- .ReadVariableNames、ReadRowNames
ReadVariableNames
ReadRowNames
テキストのみのパラメタ-DateLocale、编码
DateLocale
编码
スプレッドシトのみのパラメタ- .表、UseExcel
表
UseExcel
すべて折りたたむ
myCsvTable.datファルをテキストエディタに読み込み,その内容をプレビュします。スクリ,ンショットを以下に示します。このファ▪▪ルにはコンマ区切り列デ▪▪タが含まれています。
myCsvTable.dat
文件名=“myCsvTable.dat”;
コンマ区切りのテキストファ▪▪ルからテ▪▪ブルを作成します。作成された表Tにはファルの列ごとに1の変数が含まれ,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行にはギャップがあります。
headersAndMissing.txt
このファ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をテキストエディタ,でプレビュ,します。スクリ,ンショットを以下に示します。このファルにはスペス区切り列デタが含まれています。
mySpaceDelimTable.txt
スペスで区切られたテキストファルから表を作成します。ファesc escルの最初の行に検出可能な列名が含まれていないため,関数readtableは,既定の変数名Var1からVar5を割り当てます。
Var1
Var5
T =可读的(“mySpaceDelimTable.txt”)
T =3×5表Var1 Var2 Var3 Var4 Var5 _____ ____ ____ ______ _________ {' 45 45 M '}{“纽约”}{“真实”}{' F '} 41 32{“CA”}{“假”}{“M”}40 34{‘马’}{“假”}
コンマ区切りのテキストファ▪▪ルからテ▪▪ブルを作成します。最初の2の列を文字ベクトル,3番目の列をuint32,その次の2の列を倍精度浮動小数点数としてンポトします。最後の列のエントリを文字ベクトルとして▪▪ンポ▪▪トします。
uint32
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、双の場合は% f、uint32の場合は% uです。
% s
双
% f
% u
ファルからド語の日付を読み取り,英語の日付としてテブルに追加します。
ファereplicationルgerman_dates.txtをテキストエディタ,でプレビュ,します。スクリ,ンショットを以下に示します。値の最初の列にはドイツ語の日付が含まれ、2 番目と 3 番目の列は数値となっています。
german_dates.txt
readtableを使用してサンプルファ@ @ルを読み取ります。変換指定子は日付では% D,浮動小数点値では% fです。ファFileEncodingで指定します。日付の書式とロケ,ルは,名前と値のペアの引数DateLocaleで指定します。
% D
FileEncoding
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プロパティを表示します。
DimensionNames
T.Properties.DimensionNames
ans =1 x2单元格{' LastName}{}“变量”
“姓”は,スプレッドシ,トの最初の行の最初の列にある名前です。
“姓”
スプレッドシ,トpatients.xlsの指定した領域のデ,タを使用して表を作成します。角C2とE6の間にある5行3列の四角形領域のデタを使用します。この領域の最初の行は変数名として使用しないでください。
patients.xls
C2
E6
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の类型プロパティを確認します。
TaxiIn
TaxiOut
类型
getvaropts(选择,{“TaxiIn”,“TaxiOut”})
ans = 1x2 TextVariableImportOptions数组属性:名称类型FillValue TreatAsMissing QuoteRule Prefixes suffix EmptyFieldRule WhitespaceRule
変数TaxiInとTaxiOutの型を双に変更します。
选项= 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”に書き込みます。
“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”パラメ,タ,を保存に設定します。
“吸烟者(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 xと0 bの接頭辞が含まれている場合,16進数と2進数を自動的に読み取ります。数値は整数デ,タ型を使用して格納されます。また,このような数値に接頭辞がない場合,。
0 x
0 b
hexAndBinary.txtのファルをテキストエディタでプレビュします。このファイルには16進数と2進数に接頭辞が含まれている列がありますが,含まれていない列が1つあります。
hexAndBinary.txt
readtableを使用してファ@ @ルを読み取ります。この関数は,0 xと0 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は、数値を異なる整数クラス(uint16とuint8)に格納します。
T.Var1
uint16
uint8
类(T.Var1)
Ans = 'uint16'
类(T.Var2)
Ans = 'uint8'
16進数と2進数からインポートされた数値を格納するためのデータ型を指定するには,名前と値のペアの引数“HexType”および“BinaryType”を使用します。値を符号付き 32 ビット整数として格納します。
“HexType”
“BinaryType”
T =可读的(“hexAndBinary.txt”,“HexType”,“int32”,“BinaryType”,“int32”);类(T.Var1)
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
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'}
読み取るファ@ @ルの名前。文字ベクトルまたは字符串スカラとして指定します。
ファ电子邮箱ルの場所によって,文件名は次のいずれかの形式をとります。
場所
形式
ファ@ @ル名を文件名で指定します。
例:“myFile.txt”
“myFile.txt”
フォルダ内のファル
ファルが現在のフォルダまたはmatlabパス上のフォルダにない場合は,文件名に絶対パス名または相対パス名を指定します。
例:“C: \ myFolder \ myFile.xlsx”
“C: \ myFolder \ myFile.xlsx”
例:“dataDir \ myFile.txt”
“dataDir \ myFile.txt”
リモ,トの場所
リモトの場所に保存されたファルの場合,文件名は次の形式の统一资源定位符(URL)として指定されたファイルの絶対パスを含まなければなりません。
scheme_name: / /path_to_file/my_file.ext
scheme_name
path_to_file
my_file.ext
リモ,トの場所に基づいて,scheme_nameには次の表の値のいずれかを指定できます。
s3
wasb
wasbs
hdfs
詳細にいては,リモ,トデ,タの操作を参照してください。
例:s3: / / bucketname / path_to_file / my_file.csv '
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ファ@ @ルのみを読み取ります。
假
.xls, .xlsx, .xlsm, .xltx和.xltm
区切りテキストファe.c.ルの場合,e.c.ンポ,e.c.ト関数はファe.c.ル内の空のフィ,e.c.ルドを,南(数値変数の場合)または空の文字ベクトル(テキスト変数の場合)のどらかに変換します。テキストファ@ @ルのすべての行には同じ数の区切り記号がなければなりません。@ @ @ @ @ @ @ @ @ @ @ @ @ @。
デ,タ型:字符|字符串
字符
字符串
SpreadsheetImportOptions
DelimitedtextImportOptions
FixedWidthImportOptions
ファ@ @ル@ @ンポ@ @トオプション。関数detectImportOptionsによって作成されたSpreadsheetImportOptionsオブジェクト,DelimitedTextImportOptionsオブジェクトまたはFixedWidthImportOptionsオブジェクトとして指定します。选择オブジェクトにはデタンポトのプロセスを制御するプロパティが含まれています。各オブジェクトのプロパティの詳細にいては,該当するオブジェクトのペジを参照してください。
DelimitedTextImportOptions
オプションの名称,值の引数ペアをコンマ区切りで指定します。的名字は引数名で,价值は対応する値です。的名字は引用符で囲まなければなりません。Name1, Value1,…,的家のように,複数の名前と値のペアの引数を任意の順序で指定できます。
的名字
价值
Name1, Value1,…,的家
“ReadVariableNames”,假的
読み取り時は次のようになります。
テキストファ电子邮箱ルの場合,文件类型、ReadVariableNames、ReadRowNames、TreatAsEmpty、DatetimeType、分隔符、HeaderLines、格式、EmptyValue、MultipleDelimsAsOne、CollectOutput、CommentStyle、ExpChars、LineEnding、DateLocale、编码、HexTypeおよびBinaryTypeのパラメ,タ,名のみが適用されます。
文件类型
TreatAsEmpty
DatetimeType
分隔符
HeaderLines
格式
EmptyValue
MultipleDelimsAsOne
CollectOutput
CommentStyle
ExpChars
LineEnding
HexType
BinaryType
スプレッドシトファルの場合,文件类型、ReadVariableNames、ReadRowNames、TreatAsEmpty、DatetimeType、表、范围、UseExcelおよびTextTypeのパラメ,タ,名のみが適用されます。
范围
TextType
选择▪▪▪ReadVariableNames、ReadRowNames、DateLocale、编码、表およびUseExcelのパラメ,タ,名のみが適用されます。
“表格”
“文本”
“delimitedtext”
“fixedwidth”
ファ@ @ルの種類。“文件类型”と次の値のいずれかで構成されるコンマ区切りのペアとして指定します。
SpreadsheetImportOptionsオブジェクトを返します。
テキストファ超市超市ルのレ超市超市アウトにより,DelimitedTextImportOptionsオブジェクトまたはFixedWidthImportOptionsオブジェクトを返します。
DelimitedTextImportOptionsオブジェクトを返します。このオプションは,列が区切り文字で区切られているテキストファ。
FixedWidthImportOptionsオブジェクトを返します。このオプションは,固定幅の列をもテキストファルに使用します。
文件名にファ▪▪▪▪ル拡張子が含まれない場合,または次の拡張子以外の場合は,名前と値のペアの引数“文件类型”を使用します。
テキストファ电子邮箱ルの場合,. txt、.datまたは. csv
例:“文件类型”、“文本”
“文件类型”、“文本”
“ReadVariableNames”
真正的
1
0
最初の行を変数名として読み取るかどうかを示すンジケタ。“ReadVariableNames”と,真正的、假、1または0で構成されるコンマ区切りのペアとして指定します。指定しない場合,readtableは変数名の有無を自動的に検出します。
ンジケタ
説明
読み取る領域の最初の行にテ,ブルの変数名が含まれている場合に使用します。readtableは,検出した変数名を使用してTの各列に変数を作成します。
読み取る領域の最初の行にテ,ブルのデ,タが含まれている場合に使用します。readtableは,“Var1”,…,“VarN”の形式で既定の変数名を作成します。ここで,Nは変数の数です。
“Var1”,…,“VarN”
N
メモ:“ReadVariableNames”と“ReadRowNames”の両方の論理ンジケタが真正的の場合,readtableは領域の最初の行の最初の列にある名前をT.Properties.DimensionNamesプロパティの最初の次元の名前として読み取ります。
“ReadRowNames”
ンポ,トオプションの选择に加えて引数ReadVariableNamesを指定した場合,readtableの動作が指定に基づき変化します。
ReadVariableNamesが真正的の場合,VariableNamesRangeまたはVariableNamesLineプロパティを使用して,指定されたファ。
VariableNamesRange
VariableNamesLine
ReadVariableNamesが假の場合,VariableNamesプロパティから変数名を読み取ります。
VariableNames
最初の列を行名として読み取るかどうかを示すンジケタ。“ReadRowNames”と,假、真正的、0または1で構成されるコンマ区切りのペアとして指定します。
読み取る領域の最初の列にテ,ブルの行名ではなくデ,タが含まれている場合に使用します。
読み取る領域の最初の列にテ,ブルの行名が含まれている場合に使用します。
ンポ,トオプションの选择に加えて引数ReadRowNamesを指定した場合,readtableの動作が指定に基づき変化します。
ReadRowNamesが真正的の場合,RowNamesRangeまたはRowNameColumnプロパティを使用して,指定されたファ。
RowNamesRange
RowNameColumn
ReadRowNamesが假の場合,行名を。
“TreatAsEmpty”
空の値として扱うプレ,スホルダ,テキスト。“TreatAsEmpty”と,文字ベクトル,文字ベクトルの细胞配列,字符串または字符串配列で構成されるコンマ区切りのペアとして指定します。これらの文字に対応する表要素は南に設定されます。
“TreatAsEmpty”はファ电子邮箱ル内の数値列にのみ適用され,readtableは“-99”のような数値リテラルを受け取りません。
“-99”
例:“TreatAsEmpty”、“N / A”または“TreatAsEmpty”、“N / A”は数値列内のN/Aを南に設定します。
“TreatAsEmpty”、“N / A”
N/A
例:TreatAsEmpty,{“。”,“NA”、“N / A”}または“TreatAsEmpty”,(“。”,“NA”、“N / A”)は数値列内の.、NAおよびN/Aを南に設定します。
TreatAsEmpty,{“。”,“NA”、“N / A”}
“TreatAsEmpty”,(“。”,“NA”、“N / A”)
.
NA
“TextType”
“字符”
“字符串”
。“TextType”と“字符”または“字符串”で構成されるコンマ区切りのペアとして指定します。
“字符”-テキストデタを文字ベクトルとしてmatlabにンポトします。
“字符串”-テキストデタをstring配列としてMATLABにンポトします。
例:“TextType”、“生物炭”
“TextType”、“生物炭”
“DatetimeType”
“datetime”
“exceldatenum”
。“DatetimeType”と,“datetime”、“文本”、“exceldatenum”のいずれかの値で構成されるコンマ区切りのペアとして指定します。値“exceldatenum”はスプレッドシトファルのみに適用され,テキストファルに対しては有効ではありません。
MATLABのdatetimeデタ型
datetime
詳細にいては,datetimeを参照してください。
“DatetimeType”を“文本”として指定した場合,“TextType”パラメ,タ,で指定された値によって決まります。
“TextType”が“字符”に設定されている場合,cell配列として返します。
“TextType”が“字符串”に設定されている場合,stringの配列として返します。
Excelのシリアル日付値
シリアル日付値は,指定された基準日からの日数に等しい単一の数値です。Excelのシリアル日付値では MATLAB のシリアル日付値とは異なる基準日が使用されています。Excel の日付の詳細については、https://金宝appsupport.microsoft.com/en-us/kb/214330を参照してください。
https://金宝appsupport.microsoft.com/en-us/kb/214330
“修改”
“保存”
変数名を保持するかどうかのフラグ。VariableNamingRuleと,真正的または假のいずれかで構成されるコンマ区切りのペアとして指定します。
VariableNamingRule
“保存”——スペースや非ASCII文字を含む変数名など,有効なMATLAB識別子ではない変数名を保持。
“修改”-無効な変数名(関数isvarnameで判定)を,有効なmatlab識別子に変換。
isvarname
R2019b以降,変数名と行名には,スペースや非ASCII文字など任意の文字を含めることができます。また,英字だけでなく任意の文字で始めることができます。変数名と行名は,有効なmatlab識別子(関数isvarnameで判定)である必要はありません。これらの変数名と行名を保持するには,VariableNamingRuleの値を“保存”に設定します。
“分隔符”
フィ,ルドの区切り記号。“分隔符”と文字ベクトル,文字ベクトルの细胞配列,または字符串で構成されるコンマ区切りのペアとして指定します。分隔符は,コンマ','やピリオド“。”などの有効な文字を使用して指定します。
','
“。”
次の表は,一般的に使用されるフィ,ルドの区切り記号の一部を示しています。
指定子
フィ,ルドの区切り記号
“逗号”
コンマ
' '
“空间”
スペス
' \ t '
“标签”
タブ
“;”
“半”
セミコロン
“|”
“酒吧”
縦棒
指定されていない場合,readtableは区切り記号を自動的に検出します。
連続する区切り記号を1の区切り記号として扱うには,分隔符を文字ベクトルのcell配列として指定します。さらに,MultipleDelimsAsOneオプションも指定しなければなりません。
例:“分隔符”、“,”または“分隔符”、“逗号”
“分隔符”、“,”
“分隔符”、“逗号”
デ,タ型:字符|字符串|细胞
细胞
“HeaderLines”
ファ@ @ルの先頭でスキップする行。“HeaderLines”と正の整数で構成されるコンマ区切りのペアとして指定します。指定しない場合,readtableはスキップする行数を自動的に検出します。
デ,タ型:单|双
单
“格式”
“汽车”
ファ@ @ルの列の形式。“格式”と1文字ベクトルまたはstring,“汽车”で構成されるコンマ区切りのペアとして指定します。変換指定子は,関数textscanが受け入れる指定子と同じです。
textscan
形式を指定すると,大きなファ。格式に値を指定しない場合,readtableは%问を使用して非数値の列を解釈します。%问指定子はテキストを読み取り、必要に応じて二重引用符(")を除外します。
%问
"
名前と値のペア“格式”を指定しない場合,関数readtableは、デ、タの、ンポ、トに関数detectImportOptionsの結果を使用したかのように動作します。この動作の結果の詳細にいては,互換性にいての考慮事項を参照してください。
“格式”、“汽车”を指定する場合,作成された変数は,デ,タに応じて双配列,文字ベクトルの单元格配列,またはdatetime配列です。列全体が数値の場合,変数は双として▪▪ンポ▪▪トされます。列に数値ではない要素が含まれる場合,変数は文字ベクトルの细胞配列,または値が日付と時間を表す場合はdatetime配列として▪▪ンポ▪▪トされます。
“EmptyValue”
区切り付きテキストファルの空の数値フィルドに返す値は,“EmptyValue”およびスカラ,で構成されるコンマ区切りのペアとして指定します。
“MultipleDelimsAsOne”
0(假)
1(真正的)
複数の区切り記号の取り扱いは,“MultipleDelimsAsOne”と真正的または假で構成されるコンマ区切りのペアとして指定します。真正的の場合,etc / etc / etc / etc / etc / etc / etc / etc / etc / etc区切り記号が空白で分けられて繰り返された場合も,1の区切り記号として扱われます。分隔符オプションも指定しなければなりません。
例:“MultipleDelimsAsOne”,1
“MultipleDelimsAsOne”,1
“CollectOutput”
デタ連結を決定する論理ンジケタは,“CollectOutput”と,真正的または假とで構成されるコンマ区切りのペアとして指定します。真正的の場合,インポート関数は同じ基本MATLABクラスの連続する出力セルを連結して1つの配列にします。
“CommentStyle”
無視するテキストを示す記号。“CommentStyle”と,文字ベクトル,文字ベクトルの细胞配列,字符串,または字符串配列で構成されるコンマ区切りのペアとして指定します。
たとえば,“%”などの文字を指定して,同じ行でその記号の後に続くテキストを無視します。{'/*','*/'}のように2つの文字ベクトルの细胞配列を指定して,それらのシーケンスの間にあるすべてのテキストを無視します。
“%”
{'/*','*/'}
MATLABは,各フィールドの最初にだけコメントをチェックします(フィールド内はコメントチェック対象外です)。
例:“CommentStyle ',{'/*','*/'}
“CommentStyle ',{'/*','*/'}
“ExpChars”
“eEdD”
指数文字。“ExpChars”と文字ベクトルまたは字符串で構成されるコンマ区切りのペアとして指定します。既定の指数文字はe、E、dおよびDです。
e
E
d
D
“LineEnding”
行末の文字。“LineEnding”と文字ベクトルまたは字符串で構成されるコンマ区切りのペアとして指定します。文字ベクトルは“\ r \ n”であるか,単一の文字を指定しなければなりません。一般的な行末文字としては、改行文字(' \ n ')やキャリッジリタ,ン(' \ r ')があります。“\ r \ n”を指定すると,r \、\ n,その2の組み合わせ(\ r \ n)をすべて行末文字として扱います。
“\ r \ n”
' \ n '
' \ r '
r \
\ n
\ r \ n
既定の行末シ,ケンスは\ n、r \または\ r \ nのいずれかで,ファ。
ファイルの最後の行の末尾に欠損値および行末シーケンスが存在する場合,インポート関数はそれらのフィールドに空の値を返します。これにより,出力单元格配列C内の個々のセルが確実に同じサ@ @ズになります。
C
例:‘LineEnding’,‘:’
‘LineEnding’,‘:’
“DateLocale”
日付を読み取るロケ,ル。“DateLocale”と,xx_YYの形式の文字ベクトルまたは字符串スカラ,で構成されるコンマ区切りのペアとして指定します。ここで,次のようになります。
xx_YY
xx
YY
YYは国を表す大文字のISO 3166-1 alpha-2コ,ド
xxは言語を表す小文字2文字のiso 639-1コ,ド
ロケルの一般的な値の一覧にいては,関数datetimeの语言环境の名前と値のペア引数を参照してください。
语言环境
% D書式指定子を使用してテキストをdatetime値として読み取る場合,DateLocaleを使用して,。
ンポ,トオプション选择に加えて引数DateLocaleを指定した場合,DateLocale。
例:“DateLocale”、“ja_JP”
“DateLocale”、“ja_JP”
“编码”
“utf - 8”
“iso - 8859 - 1”
“windows - 1251”
“windows - 1252”
ファルに関連付けられた文字エンコドスキム。“编码”と“系统”で構成されるコンマ区切りのペア,または標準の文字エンコ,ドスキ,ム名として指定します。エンコ,ドを指定しない場合,関数readtableは自動文字セット検出を使用して,ファ。
“系统”
ンポ,トオプションに加えて引数“编码”を指定した場合,関数readtableは“编码”。
例:“编码”,“utf - 8”は,utf-8をエンコ,ドとして使用します。
“编码”,“utf - 8”
例:“编码”、“系统”はシステムの既定のエンコ,ドを使用します。
“编码”、“系统”
“DurationType”
“持续时间”
テキストファルからの时长デタの出力デタ型。“DurationType”と“持续时间”または“文本”のいずれかで構成されるコンマ区切りのペアとして指定します。
MATLABの持续时间デタ型
持续时间
詳細にいては,持续时间を参照してください。
“DurationType”を“文本”として指定した場合,“TextType”パラメ,タ,で指定された値によって決まります。
“TextType”が“字符”の場合,ンポト関数はdurationタを文字ベクトルのcell配列として返します。
“TextType”が“字符串”の場合,ンポト関数はdurationタをstringの配列として返します。
“int8”
“int16”
16進数デタの出力デタ型。“HexType”と表にリストされているいずれかの値で構成されるコンマ区切りのペアとして指定します。
入力ファesc escルは16進数値をテキストで表します。接頭辞として0 xまたは0 xを使用し,数字として文字0~9、一个~f,および一个~Fを使用します(大文字と小文字は同じ数値を表します。たとえば,“0 xf”と“0 xf”はどらも15を表します)。
9
一个
f
F
“0 xf”
15
化学键ンポ,化学键ト関数は,化学键16進数の値を,“HexType”の値で指定されたデ,タ型に変換します。
“HexType”の値
出力テ,ブル変数のデ,タ型
自動的に検出されるデ,タ型
変更されない入力テキスト
8ビット整数,符号付き
16ビット整数,符号付き
“int32”
32ビット整数,符号付き
“int64”
64ビット整数,符号付き
“uint8”
8ビット整数,符号なし
“uint16”
16ビット整数,符号なし
“uint32”
32ビット整数,符号なし
“uint64”
64ビット整数,符号なし
例:“HexType”、“uint16”は,16進数値を表すテキスト(“0 xff”)を出力テ,ブルの符号なし16ビット整数(255など)に変換します。
“HexType”、“uint16”
“0 xff”
255
バナリデタの出力デタ型。“BinaryType”と表にリストされているいずれかの値で構成されるコンマ区切りのペアとして指定します。
入力ファ▪▪ルはバ▪▪ナリ値をテキストで表します。接頭辞として0 bまたは0 bを使用し,数字として文字0と1を使用します。
@ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @“BinaryType”の値で指定されたデ,タ型に変換します。
“BinaryType”の値
例:“BinaryType”、“uint16”は,バ电子邮件ナリ値を表すテキスト(“0 b11111111”など)を出力テ,ブルの符号なし16ビット整数(255など)に変換します。
“BinaryType”、“uint16”
“0 b11111111”
“TrimNonNumeric”
非数値文字を数値変数から削除します。逻辑真正的または假として指定します。
例:名前と値のペアが“TrimNonNumeric”,真的のように指定される場合,“500美元/ -”を500として読み取ります。
“TrimNonNumeric”,真的
“500美元/ -”
500
デ,タ型:逻辑
逻辑
“表”
読み取るワ,クシ,ト。“表”と,ワークシートインデックスを示す正の整数またはワークシート名を含む文字ベクトルまたは字符串で構成されるコンマ区切りのペアとして指定します。ワ、クシ、ト名にコロン(:)を含めることはできません。スプレッドシトファルのシートの名前を調べるには、Sheets = sheetnames(文件名)を使用します。詳細にいては,sheetnamesを参照してください。
:
Sheets = sheetnames(文件名)
sheetnames
ンポ,トオプション选择に加えて引数表を指定した場合,関数readtableは引数表。
例:“表”,2
2
例:“表”,“MySheetName”
“MySheetName”
デ,タ型:字符|字符串|单|双|int8|int16|int32|int64|uint8|uint16|uint32|uint64
int8
int16
int64
uint64
“范围”
ワ,クシ,トの読み取り対象部分。“范围”と次のいずれかの形式の文字ベクトルまたは字符串スカラーで構成されるコンマ区切りのペアで四角形の領域として指定します。
“细胞”または(行坳)
“细胞”
(行坳)
開始セル
文字ベクトル,弦スカラー,または2要素数値ベクトルとして,データの開始セルを指定します。
ExcelのA1表記法を使用した列の文字および行番号を含む文字ベクトルまたは字符串スカラ。たとえば,A5は列一个と行5が交わる場所にあるセルの識別子です。
A1
A5
5
開始行と開始列を示す(行坳)形式の2要素数値ベクトル。
開始セルを使用して,インポート関数は,インポートを開始セルで開始し,最後の空の行またはフッター範囲で終了することで,データの範囲を自動的に検出します。
例:的A5または(5 - 1)
的A5
(5 - 1)
'Corner1: Corner2'
Corner1: Corner2
四角形の範囲
構文'Corner1: Corner2'を使用して範囲を指定します。Corner1とCorner2は,領域を定義する2の対角です。たとえば,“D2: H4”は,ワ,クシ,ト上の2の角D2とH4の間にある3行5列の四角形領域を表します。名前と値のペアの引数“范围”では大文字小文字は区別されず,Excel A1参照スタイル(Excelヘルプを参照)が使用されます。
Corner1
Corner2
“D2: H4”
D2
H4
例:“范围”、“Corner1: Corner2
“范围”、“Corner1: Corner2
''
指定なしまたは空
指定しない場合,readtableは使用範囲を自動的に検出します。
例:“范围”,“
“范围”,“
メモ:“使用範囲”とは,スプレッドシ,ト内の実際にデ,タを含んでいる四角形部分を指します。readtableは,デ,タを含んでいない前後の行と列をすべてトリミングすることで,使用範囲を自動的に検出します。空白のみのテキストはデ,タと見なされ,使用範囲内に取得されます。
'第一行:Row2'
第一行:Row2
行範囲
Excelの行指定子によって開始行と終了行を指定して,行の範囲を表すことができます。これにより,readtableは指定された行内で列の使用範囲を自動的に検出します。たとえば,readtableは範囲指定“1:7”を,1 ~ 7行目の使用範囲にあるすべての列を読み取る命令として解釈します。
“1:7”
例:“范围”、“1:7的
“范围”、“1:7的
'Column1: Column2'
Column1: Column2
列範囲
Excelの列指定子を使用して開始列と終了列を指定することで,範囲を表すことができます。これにより,readtableは指定された列内で行の使用範囲を自動的に検出します。たとえば,readtableは範囲指定“答:F”を,a ~ f列の使用範囲にあるすべての行を読み取る命令として解釈します。
“答:F”
例:“范围”、“答:F '
“范围”、“答:F '
'NamedRange'
NamedRange
Excelの名前付き範囲
Excelでは,スプレッドシ,ト内の範囲を表す名前を作成できます。たとえば,スプレッドシ,トの四角形部分を選択して“myTable”という名前を付けることができます。スプレッドシ,ト内にそのような名前付き範囲が存在する場合、readtableはその名前を使用して範囲を読み取ることができます。
“myTable”
例:“范围”、“myTable”
“范围”、“myTable”
例:“范围”,A1: F10的
A1: F10的
例:“范围”,“A1: F10”- - - - - -
“A1: F10”
“UseExcel”
スプレッドシ,トデ,タを読み取るときに,Microsoft ExcelWindows:の,Windows:ンスタンスを起動するためのフラグ。“UseExcel”と,真正的または假のいずれかで構成されるコンマ区切りのペアとして指定します。
“UseExcel”パラメ,タ,は,次の値のいずれかに設定できます。
真正的——インポート関数は,ファイルを読み取るときにMicrosoft Excelのインスタンスを起動します。
假——インポート関数は,ファイルを読み取るときにMicrosoft Excelのインスタンスを起動しません。このモードで動作しているインポート関数の機能では,サポートするファイル形式および式やマクロなどの対話型機能が異なります。
.xls, .xlsx, .xlsm, .xltx, .xltm, .xlsb, .ods
.xls, .xlsx, .xlsm, .xltx, .xltm
式やマクロなどの対話型機能のサポ,ト
あり
なし
Windowsプラットフォムでスプレッドシトファルを読み取るときにMicrosoft Excelの电子邮箱ンスタンスを起動する場合は,“UseExcel”パラメ,タ,を真正的に設定します。
テ,ブルとして返される出力テ,ブル。テブルには、説明、変数単位、変数名、行名などのメタデータを保存できます。詳細については、表格のプロパティの節を参照してください。
表格
XLSX形式の大きなファescルは読み取りに時間がかかることがあります。インポートとエクスポートのパフォーマンスを向上させるためには,XLSB形式を使用することが微软によって推奨されています。
すべて展開する
R2020aでの動作変更
既定では,関数readtableは,関数detectImportOptionsの結果を使用して表形式デタをンポトします。2 .。
T = readtable(filename,detectImportOptions(filename))
R2020aでは,readtableの既定の動作には,以前のリリ,スでの既定の動作とはいく,か違いがあります。
入力フィ,ルドまたは行の説明
R2020aのreadtableの既定の動作
以前のリリ,スでの既定の動作
出力表変数の名前として割り当てるテキストが最初の行に含まれない
名前Var1,…,VarNを出力表変数の名前として割り当てる
Var1,…,VarN
デ,タ値の最初の行の値を出力表変数の名前に変換する
ヘッダ,行としての複数行のテキスト
追加のヘッダ,行を無視する
残りの行の値を検出されたデタ型としてンポトする
追加のヘッダ、行を出力表の最初の数行のテキストとして、ンポ、トする
残りの行の値をテキストとして▪▪ンポ▪▪トする
空のフィ,ルド
検出されたデ,タ型の欠損値として扱う
空の文字ベクトルまたは字符串として扱う
引用符内の値
検出されたデ,タ型として扱う
テキストとして扱う
変換できないテキスト
数値以外の文字が,区切り記号なしで数値の後に続く
文字を非数値として扱う
数値と数値以外の文字を,区切り記号で区切られているかのように扱う
入力テキストファ@ @ルに異なる数の区切り記号を含む行がある
余分な変数を含む出力表を返す
エラ,メッセ,ジを表示する
R2019bまでの既定の動作を行うreadtableを呼び出すには,名前と値のペアの引数“格式”、“汽车”を使用します。
T = readtable(文件名,“格式”,“汽车”)
detectImportOptions|预览|readcell|readmatrix|readtimetable|readvars|setvaropts|表格|textscan|writetable|インポートツール
预览
readcell
readmatrix
readtimetable
readvars
writetable
この例の変更されたバ,ジョンがあります.編集された方の例を開きますか?
次のmatlabコマンドに対応するリンクがクリックされました。
コマンドをmatlabコマンドウィンドウに入力して実行してください。Webブラウザ,はMATLABコマンドをサポ,トしていません。
选择一个网站,在可用的地方获得翻译的内容,并查看当地的活动和优惠。根据您所在的位置,我们建议您选择:.
您也可以从以下列表中选择一个网站:
选择中国站点(中文或英文)以获得最佳站点性能。其他MathWorks国家站点没有针对您所在位置的访问进行优化。
联系当地办事处