readvars

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

構文

[Var1,Var2,...,VarN] = readvars(filename)

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

[Var1,Var2,...,VarN] = readvars(___,Name,Value)

説明

[Var1,Var2,...,VarN] = readvars(filename) は、ファイルから列方向のデータを読み取ることにより変数を作成します。ファイルに N 列のデータが含まれている場合、readvars は N 個の変数 Var1,Var2,...,VarN を返します。

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

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

例

[Var1,Var2,...,VarN] = readvars(filename,opts) は、さらにインポートオプション opts を使用します。

例

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

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

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

例

すべて折りたたむ

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

ライブスクリプトを開く

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

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

opts = detectImportOptions('outages.csv');
preview('outages.csv',opts)

ans=8×6 table
       Region           OutageTime        Loss     Customers     RestorationTime            Cause       
    _____________    ________________    ______    __________    ________________    ___________________

    {'SouthWest'}    2002-02-01 12:18    458.98    1.8202e+06    2002-02-07 16:50    {'winter storm'   }
    {'SouthEast'}    2003-01-23 00:49    530.14    2.1204e+05                 NaT    {'winter storm'   }
    {'SouthEast'}    2003-02-07 21:15     289.4    1.4294e+05    2003-02-17 08:14    {'winter storm'   }
    {'West'     }    2004-04-06 05:44    434.81    3.4037e+05    2004-04-06 06:10    {'equipment fault'}
    {'MidWest'  }    2002-03-16 06:18    186.44    2.1275e+05    2002-03-18 23:23    {'severe storm'   }
    {'West'     }    2003-06-18 02:49         0             0    2003-06-18 10:54    {'attack'         }
    {'West'     }    2004-06-20 14:39    231.29           NaN    2004-06-20 19:16    {'equipment fault'}
    {'West'     }    2002-06-06 19:28    311.86           NaN    2002-06-07 00:51    {'equipment fault'}

最初の 3 つの列をワークスペース内の別個の変数としてインポートします。

[Region,OutageTime,Loss] = readvars('outages.csv');
whos Region OutageTime Loss

  Name               Size             Bytes  Class       Attributes

  Loss            1468x1              11744  double                
  OutageTime      1468x1              23520  datetime              
  Region          1468x1             198476  cell

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

ライブスクリプトを開く

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

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

opts = detectImportOptions('patients.xls');
preview('patients.xls',opts)

ans=8×10 table
      LastName        Gender      Age              Location               Height    Weight    Smoker    Systolic    Diastolic    SelfAssessedHealthStatus
    ____________    __________    ___    _____________________________    ______    ______    ______    ________    _________    ________________________

    {'Smith'   }    {'Male'  }    38     {'County General Hospital'  }      71       176      true        124          93             {'Excellent'}      
    {'Johnson' }    {'Male'  }    43     {'VA Hospital'              }      69       163      false       109          77             {'Fair'     }      
    {'Williams'}    {'Female'}    38     {'St. Mary's Medical Center'}      64       131      false       125          83             {'Good'     }      
    {'Jones'   }    {'Female'}    40     {'VA Hospital'              }      67       133      false       117          75             {'Fair'     }      
    {'Brown'   }    {'Female'}    49     {'County General Hospital'  }      64       119      false       122          80             {'Good'     }      
    {'Davis'   }    {'Female'}    46     {'St. Mary's Medical Center'}      68       142      false       121          70             {'Good'     }      
    {'Miller'  }    {'Female'}    33     {'VA Hospital'              }      64       142      true        130          88             {'Good'     }      
    {'Wilson'  }    {'Male'  }    40     {'VA Hospital'              }      68       180      false       115          82             {'Good'     }

最初の 3 つの列をワークスペース内の別個の変数としてインポートします。

[LastName,Gender,Age] = readvars('patients.xls');
whos  LastName Gender Age

  Name            Size            Bytes  Class     Attributes

  Age           100x1               800  double              
  Gender        100x1             13012  cell                
  LastName      100x1             13216  cell

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

ライブスクリプトを開く

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

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

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 および 6 の 10 行をインポートします。

opts.Sheet = '2007';
opts.SelectedVariableNames = [5 6]; 
opts.DataRange = '2:11';
[DepTime,CRSDepTime] = readvars('airlinesmall_subset.xlsx',opts);

変数を表示します。

[DepTime, CRSDepTime]

ans = 10×2

         711         710
         652         655
        1116        1120
         825         825
        1411        1400
        1935        1935
        2005        2005
        1525        1525
        1133        1105
         922         925

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

ライブスクリプトを開く

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

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' という名前のワークシートから最初の 3 つの変数の 10 行をインポートします。

[Year, Month, DayOfMonth] = readvars('airlinesmall_subset.xlsx','Sheet','2007','Range','A2:C11');
whos Year Month DayOfMonth

  Name             Size            Bytes  Class     Attributes

  DayOfMonth      10x1                80  double              
  Month           10x1                80  double              
  Year            10x1                80  double

disp([Year Month DayOfMonth])

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

入力引数

すべて折りたたむ

`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

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

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

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

例: "TextType","char"

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

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

値説明

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

"datetime"

MATLAB の datetime データ型

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

"text"

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

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

"exceldatenum"

Excel のシリアル日付値

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

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

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

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

データ型: char | string | cell

テキストファイルのみ

すべて展開する

`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' で構成されるコンマ区切りのペア、または標準の文字エンコードスキーム名として指定します。エンコードを指定しない場合、関数 readvars は自動文字セット検出を使用して、ファイルの読み取り時にエンコードを判断します。

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

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

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

データ型: char | string

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

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

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

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

'duration'

MATLAB の duration データ型

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

'text'

'DurationType' を 'text' として指定した場合、インポートされる duration データの型は 'TextType' パラメーターで指定された値によって決まります。

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

データ型: 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: スプレッドシート内のマージされたセルのインポート方法の指定

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

参考

readtable | readtimetable | readmatrix | readcell

トピック

Control How MATLAB Imports Your Data

readvars

構文

説明

例

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

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

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

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

入力引数

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

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

名前と値の引数

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

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

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

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

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

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

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

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

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

TreatAsMissing — 欠損データとして解釈するテキスト 文字ベクトル | string スカラー | 文字ベクトルの cell 配列 | 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' | ...

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

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 スカラー | 数値ベクトル

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

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

`TreatAsMissing` — 欠損データとして解釈するテキスト
文字ベクトル | string スカラー | 文字ベクトルの cell 配列 | 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'` | ...

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

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