readmatrix

ファイルからの行列の読み取り

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

構文

A = readmatrix(filename)

A = readmatrix(filename,opts)

A = readmatrix(___,Name,Value)

説明

A = readmatrix(filename) は、ファイルから列方向のデータを読み取ることにより配列を作成します。関数 readmatrix は、ファイルのインポートパラメーターの自動検出を実行します。

readmatrix は、ファイル拡張子からファイル形式を判定します。

区切りテキストファイルの場合、.txt、.dat または .csv
スプレッドシートファイルの場合、.xls、.xlsb、.xlsm、.xlsx、.xltm, .xltx または .ods
圧縮ファイルおよびアーカイブファイルの場合、.zip、.gz、または .tar。

数値とテキストが混在するファイルの場合、readmatrix は、既定でデータを数値配列としてインポートします。

例

A = readmatrix(filename,opts) は、さらにインポートオプション opts を使用します。

例

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

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

テキストファイル — DateLocale、Encoding
スプレッドシートファイル — Sheet、UseExcel

例

すべて折りたたむ

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

ライブスクリプトを開く

basic_matrix.txt の内容を表示し、データを行列にインポートします。

type basic_matrix.txt

6,8,3,1
5,4,7,3
1,6,7,10
4,2,8,2
2,7,5,9

M = readmatrix('basic_matrix.txt')

M = 5×4

     6     8     3     1
     5     4     7     3
     1     6     7    10
     4     2     8     2
     2     7     5     9

スプレッドシートファイルからの行列の読み取り

ライブスクリプトを開く

basic_matrix.xls の数値データを行列にインポートします。

M = readmatrix('basic_matrix.xls')

M = 5×4

     6     8     3     1
     5     4     7     3
     1     6     7    10
     4     2     8     2
     2     7     5     9

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

ライブスクリプトを開く

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

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

opts = detectImportOptions('airlinesmall_subset.xlsx');
preview('airlinesmall_subset.xlsx',opts)

ans=8×29 table
    Year    Month    DayofMonth    DayOfWeek    DepTime    CRSDepTime    ArrTime    CRSArrTime    UniqueCarrier    FlightNum     TailNum      ActualElapsedTime    CRSElapsedTime    AirTime    ArrDelay    DepDelay    Origin      Dest      Distance    TaxiIn    TaxiOut    Cancelled    CancellationCode    Diverted    CarrierDelay    WeatherDelay      SDelay      SecurityDelay    LateAircraftDelay
    ____    _____    __________    _________    _______    __________    _______    __________    _____________    _________    __________    _________________    ______________    _______    ________    ________    _______    _______    ________    ______    _______    _________    ________________    ________    ____________    ____________    __________    _____________    _________________

    1996      1          18            4         2117         2120        2305         2259          {'HP'}           415       {'N637AW'}           108                 99            85           6          -3       {'COS'}    {'PHX'}      551         5         18           0           {0×0 char}          0         {0×0 char}      {0×0 char}     {0×0 char}     {0×0 char}         {0×0 char}    
    1996      1          12            5         1252         1245        1511         1500          {'HP'}           610       {'N905AW'}            79                 75            58          11           7       {'LAX'}    {'PHX'}      370         3         18           0           {0×0 char}          0         {0×0 char}      {0×0 char}     {0×0 char}     {0×0 char}         {0×0 char}    
    1996      1          16            2         1441         1445        1708         1721          {'HP'}           211       {'N165AW'}            87                 96            74         -13          -4       {'RNO'}    {'PHX'}      601         4          9           0           {0×0 char}          0         {0×0 char}      {0×0 char}     {0×0 char}     {0×0 char}         {0×0 char}    
    1996      1           1            1         2258         2300        2336         2335          {'HP'}          1245       {'N183AW'}            38                 35            20           1          -2       {'TUS'}    {'PHX'}      110         6         12           0           {0×0 char}          0         {0×0 char}      {0×0 char}     {0×0 char}     {0×0 char}         {0×0 char}    
    1996      1           4            4         1814         1814        1901         1910          {'US'}           683       {'N963VJ'}            47                 56            34          -9           0       {'DTW'}    {'PIT'}      201         6          7           0           {0×0 char}          0         {0×0 char}      {0×0 char}     {0×0 char}     {0×0 char}         {0×0 char}    
    1996      1          31            3         1822         1820        1934         1925          {'US'}           757       {'N912VJ'}            72                 65            52           9           2       {'PHL'}    {'PIT'}      267         6         14           0           {0×0 char}          0         {0×0 char}      {0×0 char}     {0×0 char}     {0×0 char}         {0×0 char}    
    1996      1          18            4          729          730         841          843          {'US'}          1564       {'N941VJ'}            72                 73            58          -2          -1       {'DCA'}    {'PVD'}      357         3         11           0           {0×0 char}          0         {0×0 char}      {0×0 char}     {0×0 char}     {0×0 char}         {0×0 char}    
    1996      1          26            5         1704         1705        1829         1839          {'NW'}          1538       {'N960N' }            85                 94            69         -10          -1       {'DTW'}    {'RIC'}      456         3         13           0           {0×0 char}          0         {0×0 char}      {0×0 char}     {0×0 char}     {0×0 char}         {0×0 char}

opts オブジェクトの値を設定し、'2007' という名前のワークシートから最初の 5 つの変数の 10 行をインポートします。

opts.Sheet = '2007';
opts.SelectedVariableNames = [1:5]; 
opts.DataRange = '2:11';
M = readmatrix('airlinesmall_subset.xlsx',opts)

M = 10×5

        2007           1           2           2         711
        2007           1           3           3         652
        2007           1           4           4        1116
        2007           1           5           5         825
        2007           1           7           7        1411
        2007           1           8           1        1935
        2007           1           9           2        2005
        2007           1          11           4        1525
        2007           1          12           5        1133
        2007           1          13           6         922

指定のシートおよび範囲からの行列の読み取り

ライブスクリプトを開く

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

opts = detectImportOptions('airlinesmall_subset.xlsx');
preview('airlinesmall_subset.xlsx',opts)

ans=8×29 table
    Year    Month    DayofMonth    DayOfWeek    DepTime    CRSDepTime    ArrTime    CRSArrTime    UniqueCarrier    FlightNum     TailNum      ActualElapsedTime    CRSElapsedTime    AirTime    ArrDelay    DepDelay    Origin      Dest      Distance    TaxiIn    TaxiOut    Cancelled    CancellationCode    Diverted    CarrierDelay    WeatherDelay      SDelay      SecurityDelay    LateAircraftDelay
    ____    _____    __________    _________    _______    __________    _______    __________    _____________    _________    __________    _________________    ______________    _______    ________    ________    _______    _______    ________    ______    _______    _________    ________________    ________    ____________    ____________    __________    _____________    _________________

    1996      1          18            4         2117         2120        2305         2259          {'HP'}           415       {'N637AW'}           108                 99            85           6          -3       {'COS'}    {'PHX'}      551         5         18           0           {0×0 char}          0         {0×0 char}      {0×0 char}     {0×0 char}     {0×0 char}         {0×0 char}    
    1996      1          12            5         1252         1245        1511         1500          {'HP'}           610       {'N905AW'}            79                 75            58          11           7       {'LAX'}    {'PHX'}      370         3         18           0           {0×0 char}          0         {0×0 char}      {0×0 char}     {0×0 char}     {0×0 char}         {0×0 char}    
    1996      1          16            2         1441         1445        1708         1721          {'HP'}           211       {'N165AW'}            87                 96            74         -13          -4       {'RNO'}    {'PHX'}      601         4          9           0           {0×0 char}          0         {0×0 char}      {0×0 char}     {0×0 char}     {0×0 char}         {0×0 char}    
    1996      1           1            1         2258         2300        2336         2335          {'HP'}          1245       {'N183AW'}            38                 35            20           1          -2       {'TUS'}    {'PHX'}      110         6         12           0           {0×0 char}          0         {0×0 char}      {0×0 char}     {0×0 char}     {0×0 char}         {0×0 char}    
    1996      1           4            4         1814         1814        1901         1910          {'US'}           683       {'N963VJ'}            47                 56            34          -9           0       {'DTW'}    {'PIT'}      201         6          7           0           {0×0 char}          0         {0×0 char}      {0×0 char}     {0×0 char}     {0×0 char}         {0×0 char}    
    1996      1          31            3         1822         1820        1934         1925          {'US'}           757       {'N912VJ'}            72                 65            52           9           2       {'PHL'}    {'PIT'}      267         6         14           0           {0×0 char}          0         {0×0 char}      {0×0 char}     {0×0 char}     {0×0 char}         {0×0 char}    
    1996      1          18            4          729          730         841          843          {'US'}          1564       {'N941VJ'}            72                 73            58          -2          -1       {'DCA'}    {'PVD'}      357         3         11           0           {0×0 char}          0         {0×0 char}      {0×0 char}     {0×0 char}     {0×0 char}         {0×0 char}    
    1996      1          26            5         1704         1705        1829         1839          {'NW'}          1538       {'N960N' }            85                 94            69         -10          -1       {'DTW'}    {'RIC'}      456         3         13           0           {0×0 char}          0         {0×0 char}      {0×0 char}     {0×0 char}     {0×0 char}         {0×0 char}

'2007' という名前のワークシートから最初の 5 つの変数の 10 行をインポートします。

M = readmatrix('airlinesmall_subset.xlsx','Sheet','2007','Range','A2:E11')

M = 10×5

        2007           1           2           2         711
        2007           1           3           3         652
        2007           1           4           4        1116
        2007           1           5           5         825
        2007           1           7           7        1411
        2007           1           8           1        1935
        2007           1           9           2        2005
        2007           1          11           4        1525
        2007           1          12           5        1133
        2007           1          13           6         922

入力引数

すべて折りたたむ

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

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

ファイルの場所によって、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'

filename にファイル拡張子が含まれる場合、インポート関数は拡張子からファイル形式を判別します。それ以外の場合は、名前と値のペアの引数 'FileType' を指定してファイルの種類を示さなければなりません。
Microsoft^® Excel^® ソフトウェアがインストールされている Windows^® システムで、インポート関数は、使用している Excel のバージョンで認識されるすべての Excel スプレッドシートファイル形式を読み取ります。
システムに Excel for Windows がない場合、または MATLAB Online™ を使用している場合、インポート関数は UseExcel プロパティが false に設定されている状態で動作し、.xls, .xlsx, .xlsm, .xltx, and .xltm ファイルのみを読み取ります。
区切りテキストファイルの場合、インポート関数はファイル内の空のフィールドを、NaN (数値変数の場合) または空の文字ベクトル (テキスト変数の場合) のどちらかに変換します。テキストファイルのすべての行には同じ数の区切り記号がなければなりません。インポート関数はファイル内の意味のない空白を無視します。
圧縮ファイル形式はファイルとして読み取られます。アーカイブファイル形式はフォルダーとして扱われます。たとえば、関数は mydatafiles.zip をフォルダーとして解釈するため、その中にある mydatafiles.zip/file1.xlsx などのファイルを指定しなければなりません。.gz 拡張子で終わるファイルの場合、関数は .gz の前にある拡張子を使用してファイル形式を判別します。たとえば、mydata.csv.gz は CSV ファイルとして読み取られます。 (R2025a 以降)

データ型: char | string

`opts` — ファイルインポートオプション
`SpreadsheetImportOptions` | `DelimitedtextImportOptions` | `FixedWidthImportOptions` | `XMLImportOptions`

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

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

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

名前と値の引数

すべて展開する

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

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

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

サポートされるすべてのファイルの種類

すべて展開する

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

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

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

すべて展開する

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

ファイルの種類。'FileType' と 'text' または 'spreadsheet' で構成されるコンマ区切りのペアとして指定します。

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

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

例: 'FileType','text'

データ型: char | string

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

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

例: 'NumHeaderLines',7

データ型: single | double

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

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

データ型: single | double

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

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

Range の指定方法説明

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

開始セル

'Cell' または [row col]

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

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

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

行範囲または列範囲

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

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

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

例: '5:500'

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

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

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

例: 'A:K'

開始行番号

n

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

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

例: 5

Excel の名前付き範囲

'NamedRange'

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

例: 'Range','myTable'

指定なしまたは空

''

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

例: 'Range',''

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

データ型: char | string | double

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

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

例: 'TreatAsMissing',{'NA','TBD'} は、インポート関数に NA または TBD のすべての出現を欠損フィールドとして処理するように指示します。

データ型: char | string | cell

`OutputType` — 出力データ型
文字ベクトル | string スカラー

出力データ型。'OutputType' と次の表のいずれかのデータ型の名前を含む文字ベクトルまたは string スカラーから構成されるコンマ区切りのペアとして指定します。

データの種類	出力データ型
数値	`'uint8'`、`'int8'`、`'int16'`、`'int32'`、`'int64'`、`'uint16'`、`'uint32'`、`'uint64'`、`'single'` または `'double'`
テキスト	`'char'` または `'string'`
その他の型	`'datetime'`、`'duration'` または `'categorical'`

例: 'OutputType','uint8'

データ型: char | string

テキストファイルのみ

すべて展開する

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

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

例: "Delimiter","|"

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

`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` — 文字エンコードスキーム
`'UTF-8'` | `'ISO-8859-1'` | `'windows-1251'` | `'windows-1252'` | ...

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

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

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

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

データ型: char | string

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

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

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

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

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

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

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

例: 'DateLocale','ja_JP'

`DecimalSeparator` — 小数点の区切りを示す文字
文字ベクトル | string スカラー

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

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

例: 名前と値のペアが 'DecimalSeparator',',' のように指定される場合、インポート関数はテキスト "3,14159" を数値 3.14159 としてインポートします。

データ型: char | string

`ThousandsSeparator` — 3 桁ごとの区切りを示す文字
文字ベクトル | string スカラー

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

例: 名前と値のペアが 'ThousandsSeparator',',' のように指定される場合、インポート関数はテキスト "1,234,000" を 1234000 としてインポートします。

データ型: char | string

`TrimNonNumeric` — 非数値文字の削除
`false` (既定値) | `true`

非数値文字を数値変数から削除します。logical true または false として指定します。

例: 名前と値のペアが 'TrimNonNumeric',true のように指定される場合、インポート関数は '$500/-' を 500 として読み取ります。

データ型: logical

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

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

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

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

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

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

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

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

先頭の区切り記号のルール	動作
`'keep'`	区切り記号を維持します。
`'ignore'`	区切り記号を無視します。
`'error'`	エラーを返し、インポート操作を中止します。

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

すべて展開する

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

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

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

データ型: char | string | single | double

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

スプレッドシートデータを読み取るときに、Microsoft Excel for Windows のインスタンスを起動するためのフラグ。'UseExcel' と、true または false のいずれかで構成されるコンマ区切りのペアとして指定します。

'UseExcel' パラメーターは、次の値のいずれかに設定できます。

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

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

Windows プラットフォームでスプレッドシートファイルを読み取るときに Microsoft Excel のインスタンスを起動する場合は、'UseExcel' パラメーターを true に設定します。

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: 圧縮ファイルおよびアーカイブファイルからのデータの読み取り

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

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

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

参考

readtable | readtimetable | readvars | readcell | writematrix

トピック

Control How MATLAB Imports Your Data

readmatrix

構文

説明

例

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

スプレッドシート ファイルからの行列の読み取り

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

指定のシートおよび範囲からの行列の読み取り

入力引数

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

opts — ファイル インポート オプション SpreadsheetImportOptions | DelimitedtextImportOptions | FixedWidthImportOptions | XMLImportOptions

名前と値の引数

サポートされるすべてのファイルの種類

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

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

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

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

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

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

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

OutputType — 出力データ型 文字ベクトル | string スカラー

テキスト ファイルのみ

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

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

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

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

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

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

DecimalSeparator — 小数点の区切りを示す文字 文字ベクトル | string スカラー

ThousandsSeparator — 3 桁ごとの区切りを示す文字 文字ベクトル | string スカラー

TrimNonNumeric — 非数値文字の削除 false (既定値) | true

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

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

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

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

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

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

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

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

バージョン履歴

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

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

参考

トピック

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

スプレッドシートファイルからの行列の読み取り

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

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

`opts` — ファイルインポートオプション
`SpreadsheetImportOptions` | `DelimitedtextImportOptions` | `FixedWidthImportOptions` | `XMLImportOptions`

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

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

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

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

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

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

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

`OutputType` — 出力データ型
文字ベクトル | string スカラー

テキストファイルのみ

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

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

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

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

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

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

`DecimalSeparator` — 小数点の区切りを示す文字
文字ベクトル | string スカラー

`ThousandsSeparator` — 3 桁ごとの区切りを示す文字
文字ベクトル | string スカラー

`TrimNonNumeric` — 非数値文字の削除
`false` (既定値) | `true`

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

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

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

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

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

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

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

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

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