主要内容

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

读单元

ファイルからの细胞配列の読み取り

説明

C = readcell (文件名)は,ファイルから列方向のデータを読み取ることにより细胞配列を作成します。

读单元は,ファイル拡張子からファイル形式を判定します。

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

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

C = readcell (文件名选择)は,さらにインポートオプション选择を使用します。

C = readcell (___名称,值)は、1.つ以上の名前と値のペアの引数で指定された追加のオプションを使用して、ファイルから 单间牢房配列を作成します。名前と値のペアを指定する前に、前述の構文の入力引数のいずれかを使用してください。

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

  • テキストファイル-DateLocale编码

  • スプレッドシートファイル-UseExcel

すべて折りたたむ

basic_cell.txtの内容を表示し,混合データを细胞配列にインポートします。

类型basic_cell.txt
1,2,3你好,世界,南部2018年10月10日10:27:56,1,
C = readcell (“basic_cell.txt”)
C =3×3单元阵列{[1]}{[2]}{[3]}{'hello'}{'world'}{[NaN]}{[10-Oct-2018 10:27:56]}{[1]}{1x1缺失}

表形式の混合データをbasic_cell.xlsから细胞配列にインポートします。

C = readcell (“basic_cell.xls”)
C =3×3单元阵列{[1]}{[2]}{[3]}{'你好'}{‘世界’}{1 x1失踪}{[10 - 10月- 2018 10:27:56]}{[1]}{1 x1失踪}

スプレッドシートファイルのデータをプレビューし,特定のシートおよび範囲から混合データを细胞配列にインポートします。

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

选择= detectImportOptions (“airlinesmall_subset.xlsx”);预览(“airlinesmall_subset.xlsx”选择)
ans=表8×29年-月-月-日-月-日-周-段时间-段时间-段时间-段时间-段时间-段时间-段时间-段时间-段时间-段时间-段时间-段时间-段时间-段时间-段时间-段时间-段时间-段时间-段时间-段时间-段时间-段时间-段时间-段时间-段时间-段时间-段时间-段-段-段-段-段-段-段-段-段-段-段-段-段-段-段-段-段-段-段-段-段-段-段-段-段-段-段-段-段-段-段-段-段-段-段-段-段-段-段-段-段-段-段-段-段-段-段-段-段-段-段-段-段-段-段-段-段-段-段-段-段-段-段_______UUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUU研究UUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUU厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄厄1996年1 18 4 2117 2120 2305 2259{'HP''415{'N637AW''108 99 6-3{'COS''PHX'}5 5 1 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 0 0 0 0 0 0 0 0 0 0 0 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 1 1 1 5 5 5 5 5 5 5 5 5 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 9674-13-4{'RNO'}{'PHX'}601490{0x0char}0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 2 5 5 5 5 5 5 3 3 3 3 3 3 3 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3'}{'PIT'}201670{0x0 char}0{0x0 char}{0x0 char}[0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1 1 1 1 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3{0x0 char}0{0x0 char}{0x0 char}{0x0 char}{0x0 char}{0x0 char}{0x0 char}1996 12651704170518291839{'NW'}1538{'N960N'}859469-10-1{'DTW'}{'RIC'}4563130{0x0 char}0{0x0 char}{0x0 char}{0x0 char}{0x0 char 0x0 char

“2007”という名前のワークシートから変数78および9の10行のデータをインポートします。Excelの範囲“G2:I11”は,列79および変数名の後の行2から始まる 10行を表します。

M = readcell (“airlinesmall_subset.xlsx”“床单”“2007”“范围”“G2:I11”)
M =10×3单元阵列{[935]}{[935]}{的WN}{[1041]}{[1040]}{的WN}{[1430]}{[1500]}{的WN}{[940]}{[950]}{的WN}{[1515]}{[1515]}{的WN}{[2042]}{[2035]}{的WN}{[2116]}{[2130]}{的WN}{[1604]}{[1605]}{的WN}{[1258]}{[1230]}{的WN} {[1134]} {[1145]} {' WN '}

入力引数

すべて折りたたむ

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

ファイルの場所によって、文件名は次のいずれかの形式をとります。

場所

形式

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

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

例:“myFile.txt”

フォルダー内のファイル

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

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

例:“dataDir \ myFile.txt”

インターネットURL

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

例:'http://hostname/path_to_file/my_data.csv'

リモートの場所

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

scheme_name://到文件的路径/my_file.ext

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

リモートの場所 scheme_name
亚马逊S3™ s3
Windows Azure®Blob存储 wasbwasbs
HDFS™ hdfs

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

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

  • 文件名にファイル拡張子が含まれる場合,インポート関数は拡張子からファイル形式を判別します。それ以外の場合は,名前と値のペアの引数“文件类型”を指定してファイルの種類を示さなければなりません。

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

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

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

データ型:烧焦|字符串

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

ファイルの種類 出力
スプレッドシート ファイル 电子表格输入オブジェクト(DataRange,およびVariableNamesプロパティにのみ使用可能)
テキストファイル DelimitedTextImportOptionsオブジェクト
固定幅テキストファイル FixedWidthImportOptionsオブジェクト
XMLファイル XMLImportOptionsオブジェクト

名前と値のペアの引数

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

例:“NumHeaderLines”,5は,表形式データの前の最初の5行がヘッダー行であることを示します。
テキストファイルとスプレッドシートファイル

すべて折りたたむ

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

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

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

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

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

データ型:烧焦|字符串

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

例:“NumHeaderLines”7

データ型:|双重的

必要な変数の数。“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”

指定なしまたは空

''

指定しない場合,使用範囲はインポート関数により自動検出されます。

例:“范围”

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

データ型:烧焦|字符串|双重的

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

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

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

例:“文本类型”,“字符”

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

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

MATLABのdatetimeデータ型

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

“文本”

“DatetimeType”“文本”として指定した場合、インポートされる日付と時刻のデータの型は“TextType”パラメーターで指定された値によって決まります。

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

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

“exceldatenum”

Excelのシリアル日付値

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

データ型:烧焦|字符串

テキストファイルのみ

すべて折りたたむ

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

例:“分隔符”,“|”

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

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

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

例:'空白',''

例:'空白','?!,'

行末の文字。文字ベクトル、一串スカラー、文字ベクトルの 单间牢房配列、または 一串配列として指定します。

例:' LineEnding ', ' \ n '

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

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

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

コメントのスタイル。文字ベクトル、一串スカラー、文字ベクトルの细胞配列、または字符串配列として指定します。

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

例:CommentStyle,{“/ *”}

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

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

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

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

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

データ型:烧焦|字符串

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

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

MATLABの持续时间データ型

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

“文本”

“DurationType”“文本”として指定した場合,インポートされる时间データの型は“TextType”パラメーターで指定された値によって決まります。

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

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

データ型:烧焦|字符串

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

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

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

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

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

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

例:“DateLocale”、“ja_JP”

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

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

データ型:烧焦|字符串

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

先頭の区切り記号のルール 動作
“保持” 区切り記号を維持します。
“忽略” 区切り記号を無視します。
“错误” エラーを返し,インポート操作を中止します。

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

先頭の区切り記号のルール 動作
“保持” 区切り記号を維持します。
“忽略” 区切り記号を無視します。
“错误” エラーを返し,インポート操作を中止します。
スプレッドシート ファイルのみ

すべて折りたたむ

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

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

データ型:烧焦|字符串||双重的

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

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

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

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

UseExcel

真正的

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

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

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

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

あり

なし

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

R2019aで導入