readcell

ファイルから cell 配列を作成する

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

構文

C = readcell(filename)

C = readcell(filename,Name,Value)

C = readcell(filename,opts)

C = readcell(filename,opts,Name,Value)

説明

C = readcell(filename) は、テキストファイルまたはスプレッドシートファイルから列方向のデータを読み取ることにより cell 配列を作成します。

例

C = readcell(filename,Name,Value) は、1 つ以上の名前と値の引数を使用してオプションを指定します。たとえば、ファイル内のヘッダーの行数、必要な変数または列の数、読み取るデータの範囲を指定できます。

例

C = readcell(filename,opts) は、インポートオプションオブジェクト opts で指定されたオプションを使用して cell 配列を作成します。インポートオプションオブジェクトを使用して、readcell でファイルを解釈する方法を構成します。インポートオプションオブジェクトは、前の 2 つの構文より詳細に制御でき、パフォーマンスが優れており、ファイルインポート構成を再利用できます。

例

C = readcell(filename,opts,Name,Value) は、インポートオプションオブジェクトと名前と値の引数の両方を使用して cell 配列を作成します。インポートオプションオブジェクトに加えて名前と値の引数を指定する場合、readcell はテキストファイルでは名前と値の引数 DateLocale および Encoding のみ、スプレッドシートファイルでは名前と値の引数 Sheet および UseExcel のみをサポートします。

例

すべて折りたたむ

テキストファイルからの読み取り

ライブスクリプトを開く

テキストファイルの内容を cell 配列にインポートします。readcell は出力 cell 配列の cell としてテキストファイルの各要素をインポートします。

C = readcell("basic_cell.txt")

C=3×3 cell array
    {[                   1]}    {[    2]}    {[        3]}
    {'hello'               }    {'world'}    {[      NaN]}
    {[10-Oct-2018 10:27:56]}    {[    1]}    {[<missing>]}

スプレッドシートからの読み取り

ライブスクリプトを開く

スプレッドシートファイルから cell 配列に表形式データをインポートします。

C = readcell("basic_cell.xls")

C=3×3 cell array
    {[                   1]}    {[    2]}    {[        3]}
    {'hello'               }    {'world'}    {[<missing>]}
    {[10-Oct-2018 10:27:56]}    {[    1]}    {[<missing>]}

スプレッドシートの指定範囲の読み取り

ライブスクリプトを開く

指定したシートと範囲のデータを cell 配列にインポートします。

airlinesmall_subset.xlsx スプレッドシートファイルには 1996 年から 2008 年のデータが複数のワークシートに分かれて含まれています。スプレッドシートファイルの各シートには、特定の年のデータがあります。

"2007" という名前のシートの列 G、H、および I から 10 行のデータをインポートします。Excel® の範囲 "G2:I11" は、列 G から I、行 2 から 11 (ヘッダー行の後の最初の 10 行) で定義されたデータ範囲を表します。

C = readcell("airlinesmall_subset.xlsx","Sheet","2007","Range","G2:I11")

C=10×3 cell array
    {[ 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'}

テキストファイルのインポートオプションの検出と使用

ライブスクリプトを開く

インポートオプションオブジェクトを使用してテキストファイルから変数のサブセットをインポートします。

関数 detectImportOptions を使用して、変数の名前と型、区切り記号、空白文字など、テキストファイルの要素を検出します。インポートオプションオブジェクト opts は検出されたファイルの要素をプロパティとして格納します。

opts = detectImportOptions("airlinesmall.csv")

opts = 
  DelimitedTextImportOptions with properties:

   Format Properties:
                    Delimiter: {','}
                   Whitespace: '\b\t '
                   LineEnding: {'\n'  '\r'  '\r\n'}
                 CommentStyle: {}
    ConsecutiveDelimitersRule: 'split'
        LeadingDelimitersRule: 'keep'
       TrailingDelimitersRule: 'ignore'
                EmptyLineRule: 'skip'
                     Encoding: 'ISO-8859-1'

   Replacement Properties:
                  MissingRule: 'fill'
              ImportErrorRule: 'fill'
             ExtraColumnsRule: 'addvars'

   Variable Import Properties: Set types by name using setvartype
                VariableNames: {'Year', 'Month', 'DayofMonth' ... and 26 more}
                VariableTypes: {'double', 'double', 'double' ... and 26 more}
        SelectedVariableNames: {'Year', 'Month', 'DayofMonth' ... and 26 more}
              VariableOptions: Show all 29 VariableOptions 
	Access VariableOptions sub-properties using setvaropts/getvaropts
           VariableNamingRule: 'modify'

   Location Properties:
                    DataLines: [2 Inf]
            VariableNamesLine: 1
               RowNamesColumn: 0
            VariableUnitsLine: 0
     VariableDescriptionsLine: 0 
	To display a preview of the table, use preview

インポートオプションオブジェクトを変更して、インポートする変数のサブセットおよび行末文字を指定します。

opts.SelectedVariableNames = ["Year","Month","DayofMonth"];
opts.LineEnding = "\n";

インポートオプションオブジェクトを指定して readcell を使用し、データのサブセットをインポートします。

C = readcell("airlinesmall.csv",opts);

入力引数

すべて折りたたむ

`filename` — 読み取るファイルの名前
string スカラー | 文字ベクトル

読み取るファイルの名前。string スカラーまたは文字ベクトルとして指定します。次のファイル形式のいずれかを指定できます。

拡張子が .txt、.dat、または .csv の区切りテキストファイルまたは固定幅テキストファイル。
- 区切りテキストファイルおよび固定幅テキストファイルの場合、readcell は空のフィールドを missing 値に変換します。
- テキストファイルのすべての行には同じ数の区切り記号がなければなりません。
- readcell はファイル内の意味のない空白を無視します。
拡張子が .xls、.xlsb、.xlsm、.xlsx、.xltm、.xltx、または .ods のスプレッドシートファイル。
- Microsoft^® Excel^® がインストールされている Windows^® システムで、readcell は、使用している Excel のバージョンで認識されるすべての Excel スプレッドシートファイル形式を読み取ります。
- システムに Excel for Windows がない場合、または MATLAB^® Online™ を使用している場合、readcell は .xls、.xlsm、.xlsx、.xltm、および .xltx の各ファイルのみを読み取ります。
拡張子が .zip、.gz、または .tar の圧縮およびアーカイブされたファイルとフォルダー。 (R2025a 以降)
- 圧縮ファイル形式はファイルとして読み取られます。
- アーカイブファイル形式はフォルダーとして扱われます。たとえば、関数は mydatafiles.zip をフォルダーとして解釈するため、その中にある mydatafiles.zip/file1.xlsx などのファイルを指定しなければなりません。
- .gz 拡張子で終わるファイルの場合、関数は .gz の前にある拡張子を使用してファイル形式を判別します。たとえば、mydata.csv.gz は CSV ファイルとして読み取られます。

filename に拡張子が含まれていない場合は、名前と値の引数 FileType を使用してファイル形式を指定します。

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

場所

形式

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

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

例: "myFile.txt"

フォルダー内のファイル

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

例: "C:\myFolder\myFile.xlsx"

例: "dataDir\myFile.txt"

インターネット URL

ファイルをインターネットの Uniform Resource Locator (URL) として指定する場合、filename には "http://" または "https://" のプロトコルタイプが含まれていなければなりません。

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

リモートの場所

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

scheme_name://path_to_file/my_file.ext

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

リモートの場所	`scheme_name`
Amazon S3™	`s3`
Windows Azure^® Blob Storage	`wasb`, `wasbs`
HDFS™	`hdfs`

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

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

`opts` — ファイルインポートオプション
`DelimitedTextImportOptions` オブジェクト | `FixedWidthImportOptions` オブジェクト | `SpreadsheetImportOptions` オブジェクト

ファイルインポートオプション。関数 detectImportOptions または関連インポートオプション関数のいずれかで作成された、次の表内のインポートオプションオブジェクトのいずれかとして指定します。インポートオプションオブジェクトにはデータインポートのプロセスを構成するプロパティが含まれています。次の表では、データのインポート時に readcell が適用する各インポートオプションオブジェクトのプロパティを示します。

ファイルの種類	インポートオプションオブジェクト	適用されるプロパティ
区切りテキストファイル	`DelimitedTextImportOptions` オブジェクト	`SelectedVariableNames` `DataLines` `Delimiter` `Whitespace` `LineEnding` `CommentStyle` `ConsecutiveDelimitersRule` `LeadingDelimitersRule` `TrailingDelimitersRule` `Encoding` `MissingRule` `EmptyLineRule` `ExtraColumnsRule`
固定幅テキストファイル	`FixedWidthImportOptions` オブジェクト	`SelectedVariableNames` `DataLines` `VariableWidths` `Whitespace` `LineEnding` `CommentStyle` `Encoding` `PartialFieldRule` `EmptyLineRule` `MissingRule` `ExtraColumnsRule`
スプレッドシートファイル	`SpreadsheetImportOptions` オブジェクト	`SelectedVariableNames` `Sheet` `DataRange` `MissingRule` `ImportErrorRule`

インポートを制御する方法の詳細については、Control How MATLAB Imports Your Dataを参照してください。

名前と値の引数

すべて展開する

オプションの引数のペアを Name1=Value1,...,NameN=ValueN として指定します。ここで、Name は引数名で、Value は対応する値です。名前と値の引数は他の引数の後に指定しなければなりませんが、ペアの順序は重要ではありません。

例: readcell(filename,NumHeaderLines=5) は、指定したファイルの最初の 5 行がヘッダー行であることを示します。

R2021a より前では、コンマを使用して名前と値をそれぞれ区切り、Name を引用符で囲みます。

例: readcell(filename,"NumHeaderLines",5) は、指定したファイルの最初の 5 行がヘッダー行であることを示します。

テキストファイル

すべて展開する

`FileType` — ファイルの種類
`"text"` | `"spreadsheet"`

ファイルの種類。"text" または "spreadsheet" として指定します。

filename にファイル拡張子が含まれない場合、または次の拡張子以外の場合は、名前と値の引数 FileType を指定します。

区切りテキストファイルまたは固定幅テキストファイルの場合、.txt、.dat または .csv
スプレッドシートファイルの場合、.xls、.xlsb、.xlsm、.xlsx、.xltm, .xltx または .ods

例: "FileType","text"

`Delimiter` — フィールドの区切り記号
string 配列 | 文字ベクトル | 文字ベクトルの cell 配列

区切りテキストファイル内のフィールドの区切り記号。string 配列、文字ベクトル、または文字ベクトルの cell 配列として指定します。

例: "Delimiter","|"

例: "Delimiter",[";","*"]

`LeadingDelimitersRule` — 先頭の区切り記号を管理する方法
`"keep"` | `"ignore"` | `"error"`

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

値	動作
`"keep"`	区切り記号を維持します。
`"ignore"`	区切り記号を無視します。
`"error"`	エラーを返し、インポート操作をキャンセルします。

`TrailingDelimitersRule` — 末尾の区切り記号を管理する方法
`"keep"` | `"ignore"` | `"error"`

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

値	動作
`"keep"`	区切り記号を維持します。
`"ignore"`	区切り記号を無視します。
`"error"`	エラーを返し、インポート操作をキャンセルします。

`ConsecutiveDelimitersRule` — 連続する区切り記号を管理する方法
`"split"` | `"join"` | `"error"`

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

値	動作
`"split"`	連続する区切り記号を複数のフィールドに分割します。
`"join"`	複数の区切り記号を結合して 1 つの区切り記号にします。
`"error"`	エラーを返し、インポート操作をキャンセルします。

`NumHeaderLines` — ヘッダーの行数
正の整数

ファイルのヘッダーの行数。正の整数として指定します。指定しない場合、readcell はファイルのヘッダーの行数を自動的に検出します。

例: "NumHeaderLines",7

`TextType` — インポートされるテキストデータの型
`"string"` | `"char"`

インポートされるテキストデータの型。次のいずれかの値として指定します。

"string" — テキストデータを string 配列としてインポートします。
"char" — テキストデータを文字ベクトルとしてインポートします。

例: "TextType","char"

`DatetimeType` — インポートされる日付と時刻のデータの型
`"datetime"` (既定値) | `"text"`

インポートされる日付と時刻のデータの型。次の表のいずれかの値として指定します。

値説明

値	説明
`"datetime"`	MATLAB の `datetime` データ型詳細については、`datetime` を参照してください。
`"text"`	インポートされる日付と時刻のデータの型は `TextType` 引数で指定された値によって決まります。 `TextType` が `"string"` に設定されている場合、`readcell` は日付を string の配列として返します。 `TextType` が `"char"` に設定されている場合、`readcell` は日付を文字ベクトルの cell 配列として返します。

"datetime"

MATLAB の datetime データ型

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

"text"

インポートされる日付と時刻のデータの型は TextType 引数で指定された値によって決まります。

TextType が "string" に設定されている場合、readcell は日付を string の配列として返します。
TextType が "char" に設定されている場合、readcell は日付を文字ベクトルの cell 配列として返します。

`ExpectedNumVariables` — 必要な変数または列の数
正の整数

必要な変数または列の数。正の整数として指定します。指定しない場合、readcell は変数または列の数を自動的に検出します。

`Range` — 読み取るデータの部分
string スカラー | 文字ベクトル | 数値ベクトル

テキストファイルから読み取るデータの部分。次のいずれかの形式をとる string スカラー、文字ベクトル、または数値ベクトルとして指定します。

Range の指定方法説明

`Range` の指定方法	説明
開始セル `"Cell"` または `[row col]`	データの開始セルを指定します。 Excel の `A1` 表記法を使用した列の文字および行番号を含む string スカラーまたは文字ベクトル。たとえば、`A5` は列 `A` と行 `5` が交わる場所にあるセルの識別子です。開始行と開始列を示す `[row col]` 形式の 2 要素数値ベクトル。開始セルを使用して、`readcell` はインポートを開始セルで開始し、最後の空の行またはフッター範囲で終了することで、データの範囲を自動的に検出します。例: `"A5"` または `[5 1]`
四角形の範囲 `"Corner1:Corner2"` または `[r1 c1 r2 c2]`	次のフォームのいずれかで四角形の範囲を使用して、読み取る範囲を正確に指定します。 `"Corner1:Corner2"` — Excel の `A1` 表記法で読み取る領域を定義する 2 つの対角を使用して範囲を指定します。たとえば、`"C2:N15"` のようにします。 `[r1 c1 r2 c2]` — 開始行、開始列、終了行および終了列を含む 4 要素数値ベクトルを使用して範囲を指定します。たとえば、`[2 3 15 13]` のようになります。 `readcell` は、指定した範囲に含まれているデータのみを読み取ります。`readcell` は指定した範囲内の空のフィールドを空の cell としてインポートします。
行範囲または列範囲 `"Row1:Row2"` または `"Column1:Column2"`	Excel の行番号を使用して、開始行と終了行を示して範囲を指定します。 `readcell` は、指定された行範囲を使用して、最初の空でない列からデータの最後まで読み取ることにより、列の範囲を自動的に検出します。`readcell` は、ファイル内のデータの列ごとに 1 つの cell 配列の列を作成します。例: `"5:500"` あるいは、Excel の列の文字または数字を使用して開始列と終了列を示して、範囲を指定します。 `readcell` は、指定された列範囲を使用して、最初の空でない行からデータの最後またはフッター範囲まで読み取ることにより、行の範囲を自動的に検出します。指定された範囲の列数は `ExpectedNumVariables` プロパティで指定された数と一致しなければなりません。例: `"A:K"`
開始行番号 `n`	正のスカラー行インデックスを使用して、データを含む最初の行を指定します。 `readcell` は、指定された行インデックスを使用して、指定された最初の行からデータの最後またはフッター範囲まで読み取ることにより、データの範囲を自動的に検出します。例: `5`
Excel の名前付き範囲 `"NamedRange"`	Excel では、スプレッドシート内の範囲を表す名前を作成できます。たとえば、スプレッドシートの四角形部分を選択して `"myTable"` という名前を付けることができます。スプレッドシート内にそのような名前付き範囲が存在する場合、`readcell` はその名前を使用して範囲を読み取ることができます。例: `"Range","myTable"`
指定なしまたは空 `""`	指定しないか空の場合、`readcell` は使用範囲を自動的に検出します。例: `"Range",""` メモ: "使用範囲" とは、スプレッドシート内の実際にデータを含んでいる四角形部分を指します。`readcell` は、データを含んでいない前後の行と列をすべてトリミングすることで、使用範囲を自動的に検出します。空白のみのテキストはデータと見なされ、使用範囲内に取得されます。

開始セル

"Cell" または [row col]

データの開始セルを指定します。

Excel の A1 表記法を使用した列の文字および行番号を含む string スカラーまたは文字ベクトル。たとえば、A5 は列 A と行 5 が交わる場所にあるセルの識別子です。
開始行と開始列を示す [row col] 形式の 2 要素数値ベクトル。

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

例: "A5" または [5 1]

四角形の範囲

"Corner1:Corner2" または [r1 c1 r2 c2]

次のフォームのいずれかで四角形の範囲を使用して、読み取る範囲を正確に指定します。

"Corner1:Corner2" — Excel の A1 表記法で読み取る領域を定義する 2 つの対角を使用して範囲を指定します。たとえば、"C2:N15" のようにします。
[r1 c1 r2 c2] — 開始行、開始列、終了行および終了列を含む 4 要素数値ベクトルを使用して範囲を指定します。たとえば、[2 3 15 13] のようになります。

readcell は、指定した範囲に含まれているデータのみを読み取ります。readcell は指定した範囲内の空のフィールドを空の cell としてインポートします。

行範囲または列範囲

"Row1:Row2" または "Column1:Column2"

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

readcell は、指定された行範囲を使用して、最初の空でない列からデータの最後まで読み取ることにより、列の範囲を自動的に検出します。readcell は、ファイル内のデータの列ごとに 1 つの cell 配列の列を作成します。

例: "5:500"

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

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

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

例: "A:K"

開始行番号

n

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

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

例: 5

Excel の名前付き範囲

"NamedRange"

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

例: "Range","myTable"

指定なしまたは空

""

指定しないか空の場合、readcell は使用範囲を自動的に検出します。

例: "Range",""

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

`WebOptions` — `HTTP` または `HTTPS` 要求オプション
`weboptions` オブジェクト

HTTP または HTTPS 要求オプション。weboptions オブジェクトとして指定します。weboptions オブジェクトは、指定した filename がプロトコルタイプ "http://" または "https://" を含むインターネット URL である場合にデータをインポートする方式を決定します。

`Whitespace` — 空白として扱う文字
文字ベクトル | string スカラー

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

例: 'Whitespace',' _'

例: 'Whitespace','?!.,'

`LineEnding` — 行末の文字
`["\n","\r","\r\n"]` (既定値) | string 配列 | 文字ベクトル | 文字ベクトルの cell 配列

行末の文字。string 配列、文字ベクトルまたは文字ベクトルの cell 配列として指定します。

例: "LineEnding","\n"

例: "LineEnding","\r\n"

例: "LineEnding",["\b",":"]

`CommentStyle` — コメントのスタイル
string 配列 | 文字ベクトル | 文字ベクトルの cell 配列

コメントのスタイル。string 配列、文字ベクトルまたは文字ベクトルの cell 配列として指定します。単一行および複数行のコメントでは、開始識別子は空白以外の最初の文字でなければなりません。単一行のコメントでは、単一の識別子を指定して、その識別子で開始している行をコメントとして扱います。複数行のコメントでは、開始識別子 (最初のもの) から終了識別子 (2 番目のもの) までの行がコメントとして扱われます。識別子の文字ベクトルを 2 つまで指定できます。

たとえば、空白以外の最初の文字としてパーセント記号に続く行を無視するには、CommentStyle を "%" に指定します。

例: "CommentStyle",["/*"]

例: "CommentStyle",["/*","*/"]

`Encoding` — 文字エンコードスキーム
`"system"` | `"UTF-8"` | `"ISO-8859-1"` | `"windows-1251"` | `"windows-1252"` | ...

ファイルに関連付けられた文字エンコードスキーム。"system" または標準の文字エンコードスキーム名として指定します。エンコードを指定しない場合、readcell は自動文字セット検出を使用して、ファイルの読み取り時にエンコードを判断します。

インポートオプションオブジェクトに加えて引数 Encoding を指定した場合、readcell は Encoding で指定された値を使用して、インポートオプションで定義されたエンコードをオーバーライドします。

例: "Encoding","UTF-8" は、UTF-8 をエンコードとして使用します。

例: "Encoding","system" はシステムの既定のエンコードを使用します。

`DurationType` — duration データの出力データ型
`"duration"` (既定値) | `"text"`

テキストファイルの duration データの出力データ型。次の表の値のいずれかとして指定します。

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

値	インポートされる duration データの型
`"duration"`	MATLAB `duration` データ型。詳細については、`duration` を参照してください。
`"text"`	インポートされる duration データの型は `TextType` 引数で指定された値によって決まります。 `TextType` が `"string"` に設定されている場合、`readcell` は duration データを string の配列として返します。 `TextType` が `"char"` に設定されている場合、`readcell` は duration データを文字ベクトルの cell 配列として返します。

"duration"

MATLAB duration データ型。

詳細については、duration を参照してください。

"text"

インポートされる duration データの型は TextType 引数で指定された値によって決まります。

TextType が "string" に設定されている場合、readcell は duration データを string の配列として返します。
TextType が "char" に設定されている場合、readcell は duration データを文字ベクトルの cell 配列として返します。

`DateLocale` — 日付を読み取るロケール
string スカラー | 文字ベクトル

日付を読み取るロケール。形式 xx_YY の string スカラーまたは文字ベクトルとして指定します。

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

次の表に一般的なロケールの値を示します。

ロケール	言語	国
`"de_DE"`	ドイツ語	ドイツ
`"en_GB"`	英語	英国
`"en_US"`	英語	米国
`"es_ES"`	スペイン語	スペイン
`"fr_FR"`	フランス語	フランス
`"it_IT"`	イタリア語	イタリア
`"ja_JP"`	日本語	日本
`"ko_KR"`	韓国語	韓国
`"nl_NL"`	オランダ語	オランダ
`"zh_CN"`	簡体字中国語	中国

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

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

例: "DateLocale","ja_JP"

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

すべて展開する

`FileType` — ファイルの種類
`"text"` | `"spreadsheet"`

ファイルの種類。"text" または "spreadsheet" として指定します。

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

区切りテキストファイルまたは固定幅テキストファイルの場合、.txt、.dat または .csv
スプレッドシートファイルの場合、.xls、.xlsb、.xlsm、.xlsx、.xltm, .xltx または .ods

例: "FileType","text"

`NumHeaderLines` — ヘッダーの行数
正の整数

ファイルのヘッダーの行数。正の整数として指定します。指定しない場合、readcell はファイルのヘッダーの行数を自動的に検出します。

例: "NumHeaderLines",7

`TextType` — インポートされるテキストデータの型
`"string"` | `"char"`

インポートされるテキストデータの型。次のいずれかの値として指定します。

"string" — テキストデータを string 配列としてインポートします。
"char" — テキストデータを文字ベクトルとしてインポートします。

例: "TextType","char"

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

インポートされる日付と時刻のデータの型。次の表のいずれかの値として指定します。

値説明

値	説明
`"datetime"`	MATLAB の `datetime` データ型詳細については、`datetime` を参照してください。
`"text"`	インポートされる日付と時刻のデータの型は `TextType` 引数で指定された値によって決まります。 `TextType` が `"string"` に設定されている場合、`readcell` は日付を string の配列として返します。 `TextType` が `"char"` に設定されている場合、`readcell` は日付を文字ベクトルの cell 配列として返します。
`"exceldatenum"`	Excel のシリアル日付値値 `"exceldatenum"` はスプレッドシートファイルのみに適用され、テキストファイルに対しては有効ではありません。シリアル日付値は、指定された基準日からの日数に等しい単一の数値です。Excel のシリアル日付値では MATLAB のシリアル日付値とは異なる基準日が使用されています。Excel の日付の詳細については、Excel の 1900 年と 1904 年の日付システムの違いを参照してください。

"datetime"

MATLAB の datetime データ型

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

"text"

インポートされる日付と時刻のデータの型は TextType 引数で指定された値によって決まります。

TextType が "string" に設定されている場合、readcell は日付を string の配列として返します。
TextType が "char" に設定されている場合、readcell は日付を文字ベクトルの cell 配列として返します。

"exceldatenum"

Excel のシリアル日付値

値 "exceldatenum" はスプレッドシートファイルのみに適用され、テキストファイルに対しては有効ではありません。シリアル日付値は、指定された基準日からの日数に等しい単一の数値です。Excel のシリアル日付値では MATLAB のシリアル日付値とは異なる基準日が使用されています。Excel の日付の詳細については、Excel の 1900 年と 1904 年の日付システムの違いを参照してください。

`ExpectedNumVariables` — 必要な変数または列の数
正の整数

必要な変数または列の数。正の整数として指定します。指定しない場合、readcell は変数または列の数を自動的に検出します。

`Sheet` — 読み取り元のシート
空の文字配列 `''` (既定値) | 文字ベクトル | string スカラー | 正の整数スカラー

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

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

`Range` — 読み取るデータの部分
string スカラー | 文字ベクトル | 数値ベクトル

スプレッドシートファイルから読み取るデータの部分。次のいずれかの形式をとる string スカラー、文字ベクトル、または数値ベクトルとして指定します。

Range の指定方法説明

`Range` の指定方法	説明
開始セル `"Cell"` または `[row col]`	データの開始セルを次のものとして指定します。 Excel の `A1` 表記法を使用した列の文字および行番号を含む string スカラーまたは文字ベクトル。たとえば、`A5` は列 `A` と行 `5` が交わる場所にあるセルの識別子です。開始行と開始列を示す `[row col]` 形式の 2 要素数値ベクトル。開始セルを使用して、`readcell` はインポートを開始セルで開始し、最後の空の行またはフッター範囲で終了することで、データの範囲を自動的に検出します。例: `"A5"` または `[5 1]`
四角形の範囲 `"Corner1:Corner2"` または `[r1 c1 r2 c2]`	次のフォームのいずれかで四角形の範囲を使用して、読み取る範囲を正確に指定します。 `"Corner1:Corner2"` — Excel の `A1` 表記法で読み取る領域を定義する 2 つの対角を使用して範囲を指定します。たとえば、`"C2:N15"` のようにします。 `[r1 c1 r2 c2]` — 開始行、開始列、終了行および終了列を含む 4 要素数値ベクトルを使用して範囲を指定します。たとえば、`[2 3 15 13]` のようになります。 `readcell` は、指定した範囲に含まれているデータのみを読み取ります。`readcell` は指定した範囲内の空のフィールドを欠損 cell としてインポートします。
行範囲または列範囲 `"Row1:Row2"` または `"Column1:Column2"`	Excel の行番号を使用して、開始行と終了行を示して範囲を指定します。 `readcell` は、指定された行範囲を使用して、最初の空でない列からデータの最後まで読み取ることにより、列の範囲を自動的に検出します。`readcell` は、ファイル内のデータの列ごとに 1 つの cell 配列の列を作成します。例: `"5:500"` あるいは、Excel の列の文字または数字を使用して開始列と終了列を示して、範囲を指定します。 `readcell` は、指定された列範囲を使用して、最初の空でない行からデータの最後またはフッター範囲まで読み取ることにより、行の範囲を自動的に検出します。指定された範囲の列数は `ExpectedNumVariables` プロパティで指定された数と一致しなければなりません。例: `"A:K"`
開始行番号 `n`	正のスカラー行インデックスを使用して、データを含む最初の行を指定します。 `readcell` は、指定された行インデックスを使用して、指定された最初の行からデータの最後またはフッター範囲まで読み取ることにより、データの範囲を自動的に検出します。例: `5`
Excel の名前付き範囲 `"NamedRange"`	Excel では、スプレッドシート内の範囲を表す名前を作成できます。たとえば、スプレッドシートの四角形部分を選択して `"myTable"` という名前を付けることができます。スプレッドシート内にそのような名前付き範囲が存在する場合、`readcell` はその名前を使用して範囲を読み取ることができます。例: `"Range","myTable"`
指定なしまたは空 `""`	指定しないか空の場合、`readcell` は使用範囲を自動的に検出します。例: `"Range",""` メモ: "使用範囲" とは、スプレッドシート内の実際にデータを含んでいる四角形部分を指します。`readcell` は、データを含んでいない前後の行と列をすべてトリミングすることで、使用範囲を自動的に検出します。空白のみのテキストはデータと見なされ、使用範囲内に取得されます。

開始セル

"Cell" または [row col]

データの開始セルを次のものとして指定します。

Excel の A1 表記法を使用した列の文字および行番号を含む string スカラーまたは文字ベクトル。たとえば、A5 は列 A と行 5 が交わる場所にあるセルの識別子です。
開始行と開始列を示す [row col] 形式の 2 要素数値ベクトル。

例: "A5" または [5 1]

四角形の範囲

"Corner1:Corner2" または [r1 c1 r2 c2]

次のフォームのいずれかで四角形の範囲を使用して、読み取る範囲を正確に指定します。

"Corner1:Corner2" — Excel の A1 表記法で読み取る領域を定義する 2 つの対角を使用して範囲を指定します。たとえば、"C2:N15" のようにします。
[r1 c1 r2 c2] — 開始行、開始列、終了行および終了列を含む 4 要素数値ベクトルを使用して範囲を指定します。たとえば、[2 3 15 13] のようになります。

readcell は、指定した範囲に含まれているデータのみを読み取ります。readcell は指定した範囲内の空のフィールドを欠損 cell としてインポートします。

行範囲または列範囲

"Row1:Row2" または "Column1:Column2"

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

例: "5:500"

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

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

例: "A:K"

開始行番号

n

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

例: 5

Excel の名前付き範囲

"NamedRange"

例: "Range","myTable"

指定なしまたは空

""

指定しないか空の場合、readcell は使用範囲を自動的に検出します。

例: "Range",""

`WebOptions` — `HTTP` または `HTTPS` 要求オプション
`weboptions` オブジェクト

`UseExcel` — Microsoft Excel for Windows のインスタンスを起動するためのフラグ
`false` または `0` (既定値) | `true` または `1`

スプレッドシートデータを読み取るときに、Microsoft Excel for Windows のインスタンスを起動するためのフラグ。以下の値のいずれかとして指定します。

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

UseExcel	`true`	`false`
サポートされているファイル形式	`.xls, .xlsx, .xlsm, .xltx, .xltm, .xlsb, .ods`	`.xls, .xlsx, .xlsm, .xltx, .xltm`
式やマクロなどの対話型機能のサポート	あり	なし

UseExcel は非対話型の自動化された環境ではサポートされません。

`MergedCellColumnRule` — 列間でセルをマージする場合のルール
`"placeleft"` (既定値) | `"placeright"` | `"duplicate"` | `"omitrow"` | `"error"`

R2024b 以降

列間でセルをマージする場合のルール。次の表のいずれかの値として指定します。

インポートルール	動作
`"placeleft"`	一番左のセルにデータを配置し、残りのセルは `FillValue` プロパティの内容で埋めます。 `FillValue` プロパティは、インポートされる変数の `VariableImportOptions` オブジェクトで指定できます。`FillValue` プロパティの設定の詳細については、`setvaropts` を参照してください。
`"placeright"`	一番右のセルにデータを配置し、残りのセルは `FillValue` プロパティの内容で埋めます。 `FillValue` プロパティは、インポートされる変数の `VariableImportOptions` オブジェクトで指定できます。`FillValue` プロパティの設定の詳細については、`setvaropts` を参照してください。
`"duplicate"`	すべてのセルにデータを複製します。
`"omitrow"`	マージされたセルがある行を除外します。
`"error"`	エラーメッセージを表示し、インポート操作をキャンセルします。

`MergedCellRowRule` — 行間でセルをマージする場合のルール
`"placetop"` (既定値) | `"placebottom"` | `"duplicate"` | `"omitvar"` | `"error"`

R2024b 以降

行間でセルをマージする場合のルール。次の表のいずれかの値として指定します。

インポートルール	動作
`"placetop"`	一番上のセルにデータを配置し、残りのセルは `FillValue` プロパティの内容で埋めます。 `FillValue` プロパティは、インポートされる変数の `VariableImportOptions` オブジェクトで指定できます。`FillValue` プロパティの設定の詳細については、`setvaropts` を参照してください。
`"placebottom"`	一番下のセルにデータを配置し、残りのセルは `FillValue` プロパティの内容で埋めます。 `FillValue` プロパティは、インポートされる変数の `VariableImportOptions` オブジェクトで指定できます。`FillValue` プロパティの設定の詳細については、`setvaropts` を参照してください。
`"duplicate"`	すべてのセルにデータを複製します。
`"omitvar"`	マージされたセルがある変数を除外します。
`"error"`	エラーメッセージを表示し、インポート操作をキャンセルします。

バージョン履歴

R2019a で導入

すべて展開する

R2025a: 圧縮ファイルおよびアーカイブファイルからのデータの読み取り

圧縮ファイルおよびアーカイブファイルからデータを cell 配列として読み取ることができます。

R2024b: スプレッドシート内のマージされたセルのインポート方法の指定

スプレッドシートからデータをインポートするとき、readcell で、名前と値の引数 MergedCellRowRule および MergedCellColumnRule を使用して、行間および列間でマージされたセルをどのようにインポートするかを指定できます。

参考

readtable | readtimetable | readmatrix | readvars | writecell

トピック

Control How MATLAB Imports Your Data

readcell

構文

説明

例

テキスト ファイルからの読み取り

スプレッドシートからの読み取り

スプレッドシートの指定範囲の読み取り

テキスト ファイルのインポート オプションの検出と使用

入力引数

filename — 読み取るファイルの名前 string スカラー | 文字ベクトル

opts — ファイル インポート オプション DelimitedTextImportOptions オブジェクト | FixedWidthImportOptions オブジェクト | SpreadsheetImportOptions オブジェクト

名前と値の引数

テキスト ファイル

FileType — ファイルの種類 "text" | "spreadsheet"

Delimiter — フィールドの区切り記号 string 配列 | 文字ベクトル | 文字ベクトルの cell 配列

LeadingDelimitersRule — 先頭の区切り記号を管理する方法 "keep" | "ignore" | "error"

TrailingDelimitersRule — 末尾の区切り記号を管理する方法 "keep" | "ignore" | "error"

ConsecutiveDelimitersRule — 連続する区切り記号を管理する方法 "split" | "join" | "error"

NumHeaderLines — ヘッダーの行数 正の整数

TextType — インポートされるテキスト データの型 "string" | "char"

DatetimeType — インポートされる日付と時刻のデータの型 "datetime" (既定値) | "text"

ExpectedNumVariables — 必要な変数または列の数 正の整数

Range — 読み取るデータの部分 string スカラー | 文字ベクトル | 数値ベクトル

WebOptions — HTTP または HTTPS 要求オプション weboptions オブジェクト

Whitespace — 空白として扱う文字 文字ベクトル | string スカラー

LineEnding — 行末の文字 ["\n","\r","\r\n"] (既定値) | string 配列 | 文字ベクトル | 文字ベクトルの cell 配列

CommentStyle — コメントのスタイル string 配列 | 文字ベクトル | 文字ベクトルの cell 配列

Encoding — 文字エンコード スキーム "system" | "UTF-8" | "ISO-8859-1" | "windows-1251" | "windows-1252" | ...

DurationType — duration データの出力データ型 "duration" (既定値) | "text"

DateLocale — 日付を読み取るロケール string スカラー | 文字ベクトル

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

FileType — ファイルの種類 "text" | "spreadsheet"

NumHeaderLines — ヘッダーの行数 正の整数

TextType — インポートされるテキスト データの型 "string" | "char"

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

ExpectedNumVariables — 必要な変数または列の数 正の整数

Sheet — 読み取り元のシート 空の文字配列 '' (既定値) | 文字ベクトル | string スカラー | 正の整数スカラー

Range — 読み取るデータの部分 string スカラー | 文字ベクトル | 数値ベクトル

WebOptions — HTTP または HTTPS 要求オプション weboptions オブジェクト

UseExcel — Microsoft Excel for Windows のインスタンスを起動するためのフラグ false または 0 (既定値) | true または 1

MergedCellColumnRule — 列間でセルをマージする場合のルール "placeleft" (既定値) | "placeright" | "duplicate" | "omitrow" | "error"

MergedCellRowRule — 行間でセルをマージする場合のルール "placetop" (既定値) | "placebottom" | "duplicate" | "omitvar" | "error"

バージョン履歴

R2025a: 圧縮ファイルおよびアーカイブ ファイルからのデータの読み取り

R2024b: スプレッドシート内のマージされたセルのインポート方法の指定

参考

トピック

テキストファイルからの読み取り

テキストファイルのインポートオプションの検出と使用

`filename` — 読み取るファイルの名前
string スカラー | 文字ベクトル

`opts` — ファイルインポートオプション
`DelimitedTextImportOptions` オブジェクト | `FixedWidthImportOptions` オブジェクト | `SpreadsheetImportOptions` オブジェクト

テキストファイル

`FileType` — ファイルの種類
`"text"` | `"spreadsheet"`

`Delimiter` — フィールドの区切り記号
string 配列 | 文字ベクトル | 文字ベクトルの cell 配列

`LeadingDelimitersRule` — 先頭の区切り記号を管理する方法
`"keep"` | `"ignore"` | `"error"`

`TrailingDelimitersRule` — 末尾の区切り記号を管理する方法
`"keep"` | `"ignore"` | `"error"`

`ConsecutiveDelimitersRule` — 連続する区切り記号を管理する方法
`"split"` | `"join"` | `"error"`

`NumHeaderLines` — ヘッダーの行数
正の整数

`TextType` — インポートされるテキストデータの型
`"string"` | `"char"`

`DatetimeType` — インポートされる日付と時刻のデータの型
`"datetime"` (既定値) | `"text"`

`ExpectedNumVariables` — 必要な変数または列の数
正の整数

`Range` — 読み取るデータの部分
string スカラー | 文字ベクトル | 数値ベクトル

`WebOptions` — `HTTP` または `HTTPS` 要求オプション
`weboptions` オブジェクト

`Whitespace` — 空白として扱う文字
文字ベクトル | string スカラー

`LineEnding` — 行末の文字
`["\n","\r","\r\n"]` (既定値) | string 配列 | 文字ベクトル | 文字ベクトルの cell 配列

`CommentStyle` — コメントのスタイル
string 配列 | 文字ベクトル | 文字ベクトルの cell 配列

`Encoding` — 文字エンコードスキーム
`"system"` | `"UTF-8"` | `"ISO-8859-1"` | `"windows-1251"` | `"windows-1252"` | ...

`DurationType` — duration データの出力データ型
`"duration"` (既定値) | `"text"`

`DateLocale` — 日付を読み取るロケール
string スカラー | 文字ベクトル

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

`FileType` — ファイルの種類
`"text"` | `"spreadsheet"`

`NumHeaderLines` — ヘッダーの行数
正の整数

`TextType` — インポートされるテキストデータの型
`"string"` | `"char"`

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

`ExpectedNumVariables` — 必要な変数または列の数
正の整数

`Sheet` — 読み取り元のシート
空の文字配列 `''` (既定値) | 文字ベクトル | string スカラー | 正の整数スカラー

`Range` — 読み取るデータの部分
string スカラー | 文字ベクトル | 数値ベクトル

`WebOptions` — `HTTP` または `HTTPS` 要求オプション
`weboptions` オブジェクト

`UseExcel` — Microsoft Excel for Windows のインスタンスを起動するためのフラグ
`false` または `0` (既定値) | `true` または `1`

`MergedCellColumnRule` — 列間でセルをマージする場合のルール
`"placeleft"` (既定値) | `"placeright"` | `"duplicate"` | `"omitrow"` | `"error"`

`MergedCellRowRule` — 行間でセルをマージする場合のルール
`"placetop"` (既定値) | `"placebottom"` | `"duplicate"` | `"omitvar"` | `"error"`

R2025a: 圧縮ファイルおよびアーカイブファイルからのデータの読み取り