readvars

ファ@ @ルからの変数の読み取り

ペ，ジ内をすべて折りたたむ

構文

[Var1, Var2,…，VarN] = readvars(filename)

[Var1, Var2,…，VarN] = readvars(filename,opts)

[Var1, Var2,…，VarN] = readvars(＿＿＿、名称、值)

説明

例

[Var1, Var2,…，VarN] = readvars(文件名）は，ファ。ファ@ @ルにN列のデ，タが含まれている場合，readvarsはN個の変数Var1 Var2,…,VarNを返します。

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

区切りテキストファ电子邮箱ルの場合，. txt、.datまたは. csv
スプレッドシトファルの場合，xls、.xlsb、.xlsm、.xlsx、.xltm，.xltxまたは。ods

例

[Var1, Var2,…，VarN] = readvars(文件名，选择）は，さらに选择を使用します。

例

[Var1, Var2,…，VarN] = readvars(＿＿＿，名称,值）は1つ以上の名前と値のペアの引数で指定された追加のオプションを使用して,ファイルから変数を作成します。名前と値のペアを指定する前に，前述の構文の入力引数のいずれかを使用してください。

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

テキストファesc escル-DateLocale、编码
スプレッドシトファル-表、UseExcel

例

すべて折りたたむ

テキストファ@ @ルからの変数の読み取り

ラ@ @ブスクリプトを開く

テキストファル内の表形式デタから列を別個の変数としてンポトします。最初に，テキストファoutages.csvの内容をプレビュ，し，列を読み取ります。

outages.csv内のデ，タをプレビュ，します。ファ@ @ルには6個の変数があります。

opts = detectImportOptions(“outages.csv”）;预览(“outages.csv”选择)

ans =8×6表地区OutageTime RestorationTime造成损失客户  _____________ ________________ ______ __________ ________________ ___________________ {' 西南的}2002-02-01 12:18 458.98 - 1.8202 e + 06 2002-02-01 16:50{“暴风雪”}{“东南”}2003-01-23 00:49 530.14 - 2.1204 e + 05 NaT{“暴风雪”}{“东南”}2003-02-07)21:15 289.4 - 1.4294 e + 05 2003-02-07 08:14{“暴风雪”}{‘西方’}2004-04-06 05:44 434.81 - 3.4037 e + 05 2004-04-06 06:10{“设备故障”}{“中西部”}2002-03-16 06:18 186.442.1275e+05 2002-03-18 23:23{'严重风暴'}{'西部'}2003-06-18 02:49 00 2003-06-18 10:54{'攻击'}{'西部'}2004-06-20 14:39 231.29 NaN 2004-06-20 19:16{'设备故障'}{'西部'}2002-06-06 19:28 311.86 NaN 2002-06-07 00:51{'设备故障'}

最初の3。

[Region,OutageTime,Loss] = readvars(“outages.csv”）;谁地区OutageTime损失

名称大小字节类属性Loss 1468x1 11744 double OutageTime 1468x1 23520 datetime Region 1468x1 174988 cell

スプレッドシトファルからの変数の読み取り

ラ@ @ブスクリプトを開く

スプレッドシトファルから列をワクスペス内の別個の変数としてンポトします。最初に，テキストファoutages.csvの内容をプレビュ，し，列を別個の変数として読み取ります。

patients.xls内のデ，タをプレビュ，します。ファ@ @ルには10個の変数があります。

opts = detectImportOptions(“patients.xls”）;预览(“patients.xls”选择)

ans =8×10的表LastName性别年龄身高体重吸烟者收缩压舒张压SelfAssessedHealthStatus位置  ____________ __________ ___ _____________________________ ______ ______ ______ ________ _________ ________________________ {' 史密斯的38}{‘男性’}{县综合医院的}71 176真正的124 93{‘优秀’}{“约翰逊”}{‘男性’}43 {VA医院的}69 163错误109 77{‘公平’}{威廉姆斯的}{‘女性’}38{圣。玛丽医疗中心'}64 131假125 83{'好'}{'琼斯'}{'女'}40 {'VA医院'}67 133假117 75{'好'}{'布朗'}{'女'}49{'县总医院'}64 119假122 80{'好'}{'戴维斯'}{'女'}46{'圣。玛丽医疗中心'}68 142假121 70{'好'}{'米勒'}{'女'}33 {'VA医院'}64 142真130 88{'好'}{'威尔逊'}{'男'}40 {'VA医院'}68 180假115 82{'好'}

最初の3。

[姓，性别，年龄]= readvars(“patients.xls”）;谁姓性别年龄

名称大小字节类属性年龄100x1 800 double性别100x1 11412 cell LastName 100x1 11616 cell

インポートオプションを使用した特定のシートおよび範囲からの変数の読み取り

ラ@ @ブスクリプトを開く

スプレッドシートファイルのデータをプレビューし,特定のシートおよび範囲からデータの列を別個の変数としてインポートします。

スプレッドシトファルairlinesmall_subset.xlsxには1996年から2008年のデタが複数のワクシトに分かれて含まれています。各ワ，クシ，トには，指定の年のデ，タがあります。ファereplicationルairlinesmall_subset.xlsxのデ，タをプレビュ，します。関数预览は，既定で最初のワ，クシ，トのデ，タを表示します。

opts = detectImportOptions(“airlinesmall_subset.xlsx”）;预览(“airlinesmall_subset.xlsx”选择)

ans =表8×29年月DayofMonth DayOfWeek DepTime CRSDepTime ArrTime CRSArrTime UniqueCarrier FlightNum TailNum ActualElapsedTime CRSElapsedTime通话时间ArrDelay DepDelay起源桌子距离TaxiIn TaxiOut取消CancellationCode转移CarrierDelay WeatherDelay SDelay SecurityDelay LateAircraftDelay  ____ _____ __________ _________ _______ __________ _______ __________ _____________ _________ __________ _________________ ______________ _______ ________ ________ _______ _______ ________ _____________ _________ ________________ ________ ____________ ____________ __________ _____________ _________________ 18 4 1996 2117 2120 2305 2259 415{“惠普”}{‘N637AW} 108 99 85 6 3{'因为'}{‘PHX} 551 5 18 0 {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} 1996 1 12 5 1252 1245 1511 1500 610{“惠普”}{‘N905AW} 79 75 58 11 7{“宽松”}{‘PHX} 370 3 18 0 {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} 1996 1 16 2 1441 1445 1708 1721 211{“惠普”}{‘N165AW} 87 9674 -13 4{‘汽车’}{‘PHX} 601 4 9 0 {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} 1996 1 1 1 2258 2300 2336 2335 1245{“惠普”}{‘N183AW} 38 35 20 1 2{“摘要”}{‘PHX} 110 6 12 0 {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} 1996 1 4 4 1814 683 1814 1901 1910{‘我们’}{‘N963VJ} 47 56 34 9 0{的DTW}{‘坑’}201 6 7 0 {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} 1996 1 31 3 1822 757 1820 1934 1925{‘我们’}{‘N912VJ} 72 65 52 9 2{‘PHL}{‘坑’}267 6 14 0 {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} 1996 1 18 4 729 1564 730 841 843{‘我们’}{‘N941VJ} 72 73 58 2 1 {DCA的}{PVD的}357 3 11 0 {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} 1996 1 26 5 1704 1705 1829 1839 1538{“西北”}{‘N960N} 85 94 69 -10 1{的DTW}{的RIC} 456 3 13 0 {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char}

选择オブジェクトの値を設定し，“2007”という名前のワ，クシ，トの列5および6の10行を▪▪ンポ▪▪トします。

选择。表=“2007”；选择。SelectedVariableNames = [5 6];选择。DataRange =“二”；[DepTime,CRSDepTime] = readvars(“airlinesmall_subset.xlsx”、选择);

変数を表示します。

[DepTime, CRSDepTime]

ans =10×2711 710 652 655 1116 1120 825 825 1411 1400 1935 1935 2005 2005 1525 1525 1133 1105 922 925

特定のシ，トおよび範囲からの変数の読み取り

ラ@ @ブスクリプトを開く

スプレッドシートファイルのデータをプレビューし,特定のシートおよび範囲から列を別個の変数としてインポートします。

opts = detectImportOptions(“airlinesmall_subset.xlsx”）;预览(“airlinesmall_subset.xlsx”选择)

ans =表8×29年月DayofMonth DayOfWeek DepTime CRSDepTime ArrTime CRSArrTime UniqueCarrier FlightNum TailNum ActualElapsedTime CRSElapsedTime通话时间ArrDelay DepDelay起源桌子距离TaxiIn TaxiOut取消CancellationCode转移CarrierDelay WeatherDelay SDelay SecurityDelay LateAircraftDelay  ____ _____ __________ _________ _______ __________ _______ __________ _____________ _________ __________ _________________ ______________ _______ ________ ________ _______ _______ ________ _____________ _________ ________________ ________ ____________ ____________ __________ _____________ _________________ 18 4 1996 2117 2120 2305 2259 415{“惠普”}{‘N637AW} 108 99 85 6 3{'因为'}{‘PHX} 551 5 18 0 {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} 1996 1 12 5 1252 1245 1511 1500 610{“惠普”}{‘N905AW} 79 75 58 11 7{“宽松”}{‘PHX} 370 3 18 0 {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} 1996 1 16 2 1441 1445 1708 1721 211{“惠普”}{‘N165AW} 87 9674 -13 4{‘汽车’}{‘PHX} 601 4 9 0 {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} 1996 1 1 1 2258 2300 2336 2335 1245{“惠普”}{‘N183AW} 38 35 20 1 2{“摘要”}{‘PHX} 110 6 12 0 {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} 1996 1 4 4 1814 683 1814 1901 1910{‘我们’}{‘N963VJ} 47 56 34 9 0{的DTW}{‘坑’}201 6 7 0 {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} 1996 1 31 3 1822 757 1820 1934 1925{‘我们’}{‘N912VJ} 72 65 52 9 2{‘PHL}{‘坑’}267 6 14 0 {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} 1996 1 18 4 729 1564 730 841 843{‘我们’}{‘N941VJ} 72 73 58 2 1 {DCA的}{PVD的}357 3 11 0 {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} 1996 1 26 5 1704 1705 1829 1839 1538{“西北”}{‘N960N} 85 94 69 -10 1{的DTW}{的RIC} 456 3 13 0 {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char}

“2007”という名前のワクシトから最初の3の変数の10行を▪▪ンポ▪▪トします。

[年月日，月月日]= readvars(“airlinesmall_subset.xlsx”，“表”，“2007”，“范围”，“A2: C11”）;谁一年月DayOfMonth

名称大小字节类属性DayOfMonth 10x1 80 double Month 10x1 80 double Year 10x1 80 double

disp([年月日])

2007 12 2007 13 2007 1 4 2007 1 5 2007 1 7 2007 1 8 2007 1 9 2007 1 11 2007 1 12 2007 1 13

入力引数

すべて折りたたむ

`文件名`- - - - - -読み取るファ@ @ルの名前
文字ベクトル|字符串スカラ

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

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

場所

形式

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

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

例:“myFile.txt”

フォルダ内のファル

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

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

例:“dataDir \ 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存储	`wasb`，`wasbs`
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.ルドを，南(数値変数の場合)または空の文字ベクトル(テキスト変数の場合)のどらかに変換します。テキストファ@ @ルのすべての行には同じ数の区切り記号がなければなりません。@ @ @ @ @ @ @ @ @ @ @ @ @ @。

デ，タ型:字符|字符串

`选择`- - - - - -ファ@ @ル@ @ンポ@ @トオプション
`SpreadsheetImportOptions`|`DelimitedtextImportOptions`|`FixedWidthImportOptions`|`XMLImportOptions`

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

ファ@ @ルの種類	出力
スプレッドシトファル	`SpreadsheetImportOptions`オブジェクト(`表`、`DataRange`，および`VariableNames`プロパティにのみ使用可能)
テキストファ@ @ル	`DelimitedTextImportOptions`オブジェクト
固定幅テキストファ@ @ル	`FixedWidthImportOptions`オブジェクト
XMLファescル	`XMLImportOptions`オブジェクト

名前と値のペアの引数

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

例:“NumHeaderLines”,5は，表形式デ，タの前の最初の5行がヘッダ，行であることを示します。

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

すべて折りたたむ

`文件类型`- - - - - -ファ@ @ルの種類
`“文本”`|`“表格”`

ファ@ @ルの種類。“文件类型”と“文本”または“表格”で構成されるコンマ区切りのペアとして指定します。

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

区切りテキストファ电子邮箱ルの場合，. txt、.datまたは. csv
スプレッドシトファルの場合，xls、.xlsb、.xlsm、.xlsx、.xltm，.xltxまたは。ods

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

デ，タ型:字符|字符串

`NumHeaderLines`- - - - - -ヘッダ，の行数
正の整数

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

例:“NumHeaderLines”7

デ，タ型:单|双

`ExpectedNumVariables`- - - - - -必要な変数の数
正の整数

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

デ，タ型:单|双

`范围`- - - - - -読み取るデ，タの部分
文字ベクトル|字符串スカラ|数値ベクトル

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

范围の指定方法説明

`范围`の指定方法	説明
開始セル `“细胞”`または`(行坳)`	文字ベクトル,弦スカラー,または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”`
指定なしまたは空 `”`	指定しない場合，使用範囲は。例:`“范围”,“` メモ:“使用範囲”とは，スプレッドシ，ト内で実際にデ，タが含まれている四角形部分を指します。ンポ，ト関数は，データを含まない先頭と末尾の行と列をすべてトリミングして、使用範囲を自動的に検出します。空白のみのテキストはデータと見なされ、使用範囲内に取得されます。

開始セル

“细胞”または(行坳)

文字ベクトル,弦スカラー,または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”

指定なしまたは空

”

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

例:“范围”,“

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

デ，タ型:字符|字符串|双

`TextType`- - - - - -インポートされるテキストデータの型
`“字符”`(既定値) |`“字符串”`

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

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

例:“TextType”、“生物炭”

`DatetimeType`- - - - - -インポートされる日付と時刻のデータの型
`“datetime”`(既定値) |`“文本”`|`“exceldatenum”`(スプレッドシ、トファ、ルのみ)

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

“datetime”

MATLABのdatetimeデタ型

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

“文本”

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

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

“exceldatenum”

Excelのシリアル日付値

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

デ，タ型:字符|字符串

`TreatAsMissing`- - - - - -欠損デ，タとして解釈するテキスト
文字ベクトル|字符串スカラ|文字ベクトルのcell配列|字符串配列

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

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

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

テキストファ@ @ルのみ

すべて折りたたむ

`分隔符`- - - - - -フィ，ルドの区切り記号
文字ベクトル|字符串スカラ|文字ベクトルのcell配列|字符串配列

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

例:“分隔符”,“|”

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

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

`空格`- - - - - -空白として扱う文字
文字ベクトル|字符串スカラ

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

例:“空白”、“_”

例:“空白”、“? !”

`LineEnding`- - - - - -行末の文字
`{' \ n ', ' \ r ', ' \ r \ n '}`(既定値) |文字ベクトル|字符串スカラ|文字ベクトルのcell配列|字符串配列

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

例:' LineEnding ', ' \ n '

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

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

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

`CommentStyle`- - - - - -コメントのスタ@ @ル
文字ベクトル|字符串スカラ|文字ベクトルのcell配列|字符串配列

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

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

例:CommentStyle,{“/ *”}

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

`编码`- - - - - -文字エンコ，ドスキ，ム
`“utf - 8”`|`“iso - 8859 - 1”`|`“windows - 1251”`|`“windows - 1252”`|……

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

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

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

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

デ，タ型:字符|字符串

`DurationType`- - - - - -持续时间デ，タの出力デ，タ型
`“持续时间”`(既定値) |`“文本”`

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

値インポートされる时间データの型

値	インポートされる时间データの型
`“持续时间”`	MATLABの`持续时间`デタ型詳細にいては，`持续时间`を参照してください。
`“文本”`	`“DurationType”`を`“文本”`として指定した場合，`“TextType”`パラメ，タ，で指定された値によって決まります。 `“TextType”`が`“字符”`に設定されている場合,インポート関数は时间データを文字ベクトルの细胞配列として返します。 `“TextType”`が`“字符串”`に設定されている場合,インポート関数は时间データを字符串の配列として返します。

“持续时间”

MATLABの持续时间デタ型

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

“文本”

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

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

デ，タ型:字符|字符串

`DateLocale`- - - - - -日付を読み取るロケ，ル
文字ベクトル|字符串スカラ

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

YYは国を表す大文字のISO 3166-1 alpha-2コ，ド
xxは言語を表す小文字2文字のiso 639-1コ，ド

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

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

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

例:“DateLocale”、“ja_JP”

`DecimalSeparator`- - - - - -小数点の区切りを示す文字
文字ベクトル|字符串スカラ

数値変数内の小数点の区切りを示す文字。文字ベクトルまたは字符串スカラとして指定します。ンポ，ト関数は，DecimalSeparatorの名前と値のペアで指定される文字を使用して，数値の整数部分と小数部分を区別します。

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

例:名前と値のペアが“DecimalSeparator”、“,”のように指定される場合，“14159”を数値3.14159として▪▪ンポ▪▪トします。

デ，タ型:字符|字符串

`ThousandsSeparator`- - - - - -3桁ごとの区切りを示す文字
文字ベクトル|字符串スカラ

数値変数内の3桁ごとの区切りを示す文字。文字ベクトルまたは字符串スカラとして指定します。3桁ごとの区切り文字は視覚的な区切りとして機能し，数値を3桁ごとにグル，プ化します。ンポ，ト関数は，ThousandsSeparatorの名前と値のペアで指定される文字を使用して，。

例:名前と値のペアが“ThousandsSeparator”、“,”のように指定される場合，“1234000”を1234000として▪▪ンポ▪▪トします。

デ，タ型:字符|字符串

`TrimNonNumeric`- - - - - -非数値文字の削除
`假`(既定値) |`真正的`

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

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

デ，タ型:逻辑

`ConsecutiveDelimitersRule`- - - - - -連続する区切り記号を処理する方法
`“分裂”`|`“加入”`|`“错误”`

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

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

デ，タ型:字符|字符串

`LeadingDelimitersRule`- - - - - -先頭の区切り記号を管理する方法
`“保持”`|`“忽略”`|`“错误”`

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

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

`TrailingDelimitersRule`- - - - - -末尾の区切り記号を管理する方法
`“保持”`|`“忽略”`|`“错误”`

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

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

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

すべて折りたたむ

`表`- - - - - -読み取り元のシ，ト
空の文字配列`”`(既定値) |文字ベクトル|字符串スカラ|正のスカラ，整数

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

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

デ，タ型:字符|字符串|单|双

`UseExcel`- - - - - -Microsoft Excel for WindowsのExcel for Windowsンスタンスを起動するためのフラグ
`假`(既定値) |`真正的`

スプレッドシ，トデ，タを読み取るときに，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”パラメ，タ，を真正的に設定します。

参考

readtable|readtimetable|readmatrix|readcell

R2019aで導入

readvars

構文

説明

例

テキストファ@ @ルからの変数の読み取り

スプレッドシトファルからの変数の読み取り

インポートオプションを使用した特定のシートおよび範囲からの変数の読み取り

特定のシ，トおよび範囲からの変数の読み取り

入力引数

`文件名`- - - - - -読み取るファ@ @ルの名前
文字ベクトル|字符串スカラ

`选择`- - - - - -ファ@ @ル@ @ンポ@ @トオプション
`SpreadsheetImportOptions`|`DelimitedtextImportOptions`|`FixedWidthImportOptions`|`XMLImportOptions`

名前と値のペアの引数

`文件类型`- - - - - -ファ@ @ルの種類
`“文本”`|`“表格”`

`NumHeaderLines`- - - - - -ヘッダ，の行数
正の整数

`ExpectedNumVariables`- - - - - -必要な変数の数
正の整数

`范围`- - - - - -読み取るデ，タの部分
文字ベクトル|字符串スカラ|数値ベクトル

`TextType`- - - - - -インポートされるテキストデータの型
`“字符”`(既定値) |`“字符串”`

`DatetimeType`- - - - - -インポートされる日付と時刻のデータの型
`“datetime”`(既定値) |`“文本”`|`“exceldatenum”`(スプレッドシ、トファ、ルのみ)

`TreatAsMissing`- - - - - -欠損デ，タとして解釈するテキスト
文字ベクトル|字符串スカラ|文字ベクトルのcell配列|字符串配列

`分隔符`- - - - - -フィ，ルドの区切り記号
文字ベクトル|字符串スカラ|文字ベクトルのcell配列|字符串配列

`空格`- - - - - -空白として扱う文字
文字ベクトル|字符串スカラ

`LineEnding`- - - - - -行末の文字
`{' \ n ', ' \ r ', ' \ r \ n '}`(既定値) |文字ベクトル|字符串スカラ|文字ベクトルのcell配列|字符串配列

`CommentStyle`- - - - - -コメントのスタ@ @ル
文字ベクトル|字符串スカラ|文字ベクトルのcell配列|字符串配列

`编码`- - - - - -文字エンコ，ドスキ，ム
`“utf - 8”`|`“iso - 8859 - 1”`|`“windows - 1251”`|`“windows - 1252”`|……

`DurationType`- - - - - -持续时间デ，タの出力デ，タ型
`“持续时间”`(既定値) |`“文本”`

`DateLocale`- - - - - -日付を読み取るロケ，ル
文字ベクトル|字符串スカラ

`DecimalSeparator`- - - - - -小数点の区切りを示す文字
文字ベクトル|字符串スカラ

`ThousandsSeparator`- - - - - -3桁ごとの区切りを示す文字
文字ベクトル|字符串スカラ

`TrimNonNumeric`- - - - - -非数値文字の削除
`假`(既定値) |`真正的`

`ConsecutiveDelimitersRule`- - - - - -連続する区切り記号を処理する方法
`“分裂”`|`“加入”`|`“错误”`

`LeadingDelimitersRule`- - - - - -先頭の区切り記号を管理する方法
`“保持”`|`“忽略”`|`“错误”`

`TrailingDelimitersRule`- - - - - -末尾の区切り記号を管理する方法
`“保持”`|`“忽略”`|`“错误”`

`表`- - - - - -読み取り元のシ，ト
空の文字配列`”`(既定値) |文字ベクトル|字符串スカラ|正のスカラ，整数

`UseExcel`- - - - - -Microsoft Excel for WindowsのExcel for Windowsンスタンスを起動するためのフラグ
`假`(既定値) |`真正的`

参考

Matlabドキュメンテ，ション

サポト

matlabで始めるディ，プラ，ニング

readvars

構文

説明

例

テキストファ@ @ルからの変数の読み取り

スプレッドシトファルからの変数の読み取り

インポートオプションを使用した特定のシートおよび範囲からの変数の読み取り

特定のシ，トおよび範囲からの変数の読み取り

入力引数

文件名- - - - - -読み取るファ@ @ルの名前文字ベクトル|字符串スカラ

选择- - - - - -ファ@ @ル@ @ンポ@ @トオプションSpreadsheetImportOptions|DelimitedtextImportOptions|FixedWidthImportOptions|XMLImportOptions

名前と値のペアの引数

文件类型- - - - - -ファ@ @ルの種類“文本”|“表格”

NumHeaderLines- - - - - -ヘッダ，の行数正の整数

ExpectedNumVariables- - - - - -必要な変数の数正の整数

范围- - - - - -読み取るデ，タの部分文字ベクトル|字符串スカラ|数値ベクトル

TextType- - - - - -インポートされるテキストデータの型“字符”(既定値) |“字符串”

DatetimeType- - - - - -インポートされる日付と時刻のデータの型“datetime”(既定値) |“文本”|“exceldatenum”(スプレッドシ、トファ、ルのみ)

TreatAsMissing- - - - - -欠損デ，タとして解釈するテキスト文字ベクトル|字符串スカラ|文字ベクトルのcell配列|字符串配列

分隔符- - - - - -フィ，ルドの区切り記号文字ベクトル|字符串スカラ|文字ベクトルのcell配列|字符串配列

空格- - - - - -空白として扱う文字文字ベクトル|字符串スカラ

LineEnding- - - - - -行末の文字{' \ n ', ' \ r ', ' \ r \ n '}(既定値) |文字ベクトル|字符串スカラ|文字ベクトルのcell配列|字符串配列

CommentStyle- - - - - -コメントのスタ@ @ル文字ベクトル|字符串スカラ|文字ベクトルのcell配列|字符串配列

编码- - - - - -文字エンコ，ドスキ，ム“utf - 8”|“iso - 8859 - 1”|“windows - 1251”|“windows - 1252”|……

DurationType- - - - - -持续时间デ，タの出力デ，タ型“持续时间”(既定値) |“文本”

DateLocale- - - - - -日付を読み取るロケ，ル文字ベクトル|字符串スカラ

DecimalSeparator- - - - - -小数点の区切りを示す文字文字ベクトル|字符串スカラ

ThousandsSeparator- - - - - -3桁ごとの区切りを示す文字文字ベクトル|字符串スカラ

TrimNonNumeric- - - - - -非数値文字の削除假(既定値) |真正的

ConsecutiveDelimitersRule- - - - - -連続する区切り記号を処理する方法“分裂”|“加入”|“错误”

LeadingDelimitersRule- - - - - -先頭の区切り記号を管理する方法“保持”|“忽略”|“错误”

TrailingDelimitersRule- - - - - -末尾の区切り記号を管理する方法“保持”|“忽略”|“错误”

表- - - - - -読み取り元のシ，ト空の文字配列”(既定値) |文字ベクトル|字符串スカラ|正のスカラ，整数

UseExcel- - - - - -Microsoft Excel for WindowsのExcel for Windowsンスタンスを起動するためのフラグ假(既定値) |真正的

参考

Matlabドキュメンテ，ション

サポト

matlabで始めるディ，プラ，ニング

`文件名`- - - - - -読み取るファ@ @ルの名前
文字ベクトル|字符串スカラ

`选择`- - - - - -ファ@ @ル@ @ンポ@ @トオプション
`SpreadsheetImportOptions`|`DelimitedtextImportOptions`|`FixedWidthImportOptions`|`XMLImportOptions`

`文件类型`- - - - - -ファ@ @ルの種類
`“文本”`|`“表格”`

`NumHeaderLines`- - - - - -ヘッダ，の行数
正の整数

`ExpectedNumVariables`- - - - - -必要な変数の数
正の整数

`范围`- - - - - -読み取るデ，タの部分
文字ベクトル|字符串スカラ|数値ベクトル

`TextType`- - - - - -インポートされるテキストデータの型
`“字符”`(既定値) |`“字符串”`

`DatetimeType`- - - - - -インポートされる日付と時刻のデータの型
`“datetime”`(既定値) |`“文本”`|`“exceldatenum”`(スプレッドシ、トファ、ルのみ)

`TreatAsMissing`- - - - - -欠損デ，タとして解釈するテキスト
文字ベクトル|字符串スカラ|文字ベクトルのcell配列|字符串配列

`分隔符`- - - - - -フィ，ルドの区切り記号
文字ベクトル|字符串スカラ|文字ベクトルのcell配列|字符串配列

`空格`- - - - - -空白として扱う文字
文字ベクトル|字符串スカラ

`LineEnding`- - - - - -行末の文字
`{' \ n ', ' \ r ', ' \ r \ n '}`(既定値) |文字ベクトル|字符串スカラ|文字ベクトルのcell配列|字符串配列

`CommentStyle`- - - - - -コメントのスタ@ @ル
文字ベクトル|字符串スカラ|文字ベクトルのcell配列|字符串配列

`编码`- - - - - -文字エンコ，ドスキ，ム
`“utf - 8”`|`“iso - 8859 - 1”`|`“windows - 1251”`|`“windows - 1252”`|……

`DurationType`- - - - - -持续时间デ，タの出力デ，タ型
`“持续时间”`(既定値) |`“文本”`

`DateLocale`- - - - - -日付を読み取るロケ，ル
文字ベクトル|字符串スカラ

`DecimalSeparator`- - - - - -小数点の区切りを示す文字
文字ベクトル|字符串スカラ

`ThousandsSeparator`- - - - - -3桁ごとの区切りを示す文字
文字ベクトル|字符串スカラ

`TrimNonNumeric`- - - - - -非数値文字の削除
`假`(既定値) |`真正的`

`ConsecutiveDelimitersRule`- - - - - -連続する区切り記号を処理する方法
`“分裂”`|`“加入”`|`“错误”`

`LeadingDelimitersRule`- - - - - -先頭の区切り記号を管理する方法
`“保持”`|`“忽略”`|`“错误”`

`TrailingDelimitersRule`- - - - - -末尾の区切り記号を管理する方法
`“保持”`|`“忽略”`|`“错误”`

`表`- - - - - -読み取り元のシ，ト
空の文字配列`”`(既定値) |文字ベクトル|字符串スカラ|正のスカラ，整数

`UseExcel`- - - - - -Microsoft Excel for WindowsのExcel for Windowsンスタンスを起動するためのフラグ
`假`(既定値) |`真正的`