最新のリリースでは、このページがまだ翻訳されていません。このページの最新版は英語でご覧になれます。

readtable

ファイルからのテーブルの作成

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

構文

T = readtable(filename)

T = readtable(filename,Name,Value)

T = readtable(filename,opts)

T = readtable(filename,opts,Name,Value)

説明

例

T = readtable(filename) は、ファイルから列データを読み取ることによって table を作成します。

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

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

readtable は、ファイルの列ごとに 1 つの変数を T に作成し、ファイルの最初の行から変数名を読み取ります。既定では、作成される変数は、列全体が数値の場合は double、列に数値以外の要素がある場合は文字ベクトルの cell 配列になります。

例

T = readtable(filename,Name,Value) は、1 つ以上の名前と値のペアの引数で指定された追加のオプションを使用して、ファイルから table を作成します。

たとえば、readtable でファイルの最初の行を変数名として読み取るかデータとして読み取るかを指定することができます。

例

T = readtable(filename,opts) は、インポートオプションの opts を使用して table を作成します。

T = readtable(filename,opts,Name,Value) は、インポートオプションと、ReadVariableNames、ReadRowNames、DateLocale、Encoding、Sheet および Basic の名前と値のペア引数の 1 つ以上によって指定された追加のオプションを使用して table を作成します。

例

すべて折りたたむ

テキストファイルからのテーブルの作成

ライブスクリプトを開く

myCsvTable.dat ファイルをテキストエディターに読み込み、その内容をプレビューします。スクリーンショットを以下に示します。このファイルにはコンマ区切り列データが含まれています。

filename = fullfile(matlabroot,'examples','matlab','myCsvTable.dat');

コンマ区切りのテキストファイルからテーブルを作成します。作成された table T にはファイルの列ごとに 1 つの変数が含まれ、readtable はファイルの最初の行のエントリを変数名として扱います。

T = readtable(filename)

T=5×6 table
     LastName     Gender    Age    Height    Weight    Smoker
    __________    ______    ___    ______    ______    ______

    'Smith'        'M'      38       71       176        1   
    'Johnson'      'M'      43       69       163        0   
    'Williams'     'F'      38       64       131        0   
    'Jones'        'F'      40       67       133        0   
    'Brown'        'F'      49       64       119        0

テキストファイルからの列見出しのないテーブルの作成

ライブスクリプトを開く

mySpaceDelimTable.txt ファイルをテキストエディターに読み込み、その内容をプレビューします。スクリーンショットを以下に示します。このファイルにはスペース区切り列データが含まれています。

filename = fullfile(matlabroot,'examples','matlab','mySpaceDelimTable.txt');

スペース区切りのテキストファイルから列見出しとしての変数名を含まないテーブルを作成します。

T = readtable(filename,...
    'Delimiter',' ','ReadVariableNames',false)

T=3×5 table
    Var1    Var2    Var3    Var4     Var5  
    ____    ____    ____    ____    _______

    'M'      45      45     'NY'    'true' 
    'F'      41      32     'CA'    'false'
    'M'      40      34     'MA'    'false'

T には、既定の変数名が含まれます。

テキストファイルからのテーブルの作成と形式の設定

ライブスクリプトを開く

filename = fullfile(matlabroot,'examples','matlab','myCsvTable.dat');

コンマ区切りのテキストファイルからテーブルを作成します。最初の 2 つの列を文字ベクトル、3 番目の列を uint32、その次の 2 つの列を倍精度浮動小数点数としてインポートします。最後の列のエントリを文字ベクトルとしてインポートします。

T = readtable(filename,'Format','%s%s%u%f%f%s')

T=5×6 table
     LastName     Gender    Age    Height    Weight    Smoker
    __________    ______    ___    ______    ______    ______

    'Smith'        'M'      38       71       176       '1'  
    'Johnson'      'M'      43       69       163       '0'  
    'Williams'     'F'      38       64       131       '0'  
    'Jones'        'F'      40       67       133       '0'  
    'Brown'        'F'      49       64       119       '0'

変換指定子は、文字ベクトルの cell 配列の場合は %s、double の場合は %f、uint32 の場合は %u です。

テキストファイルからの外国語の日付の読み取り

ライブスクリプトを開く

ファイルからドイツ語の日付を読み取り、英語の日付としてテーブルに追加します。

german_dates.txt ファイルをテキストエディターに読み込み、その内容をプレビューします。スクリーンショットを以下に示します。値の最初の列にはドイツ語の日付が含まれ、2 番目と 3 番目の列は数値となっています。

filename = fullfile(matlabroot,'examples','matlab','german_dates.txt');

readtable を使用してサンプルファイルを読み取ります。変換指定子は日付では %D、浮動小数点値では %f です。ファイルのエンコードは、名前と値のペアの引数 FileEncoding で指定します。日付の書式とロケールは、名前と値のペアの引数 DateLocale で指定します。

T = readtable(filename,'ReadVariableNames',false,...
    'Format','%{dd MMMM yyyy}D %f %f',...
    'FileEncoding','ISO-8859-15',...
    'DateLocale','de_DE')

T=3×3 table
          Var1          Var2    Var3 
    ________________    ____    _____

     01 January 2014    20.2    100.5
    01 February 2014    21.6    102.7
       01 March 2014    20.7     99.8

スプレッドシートからの行名を含むテーブルの作成

ライブスクリプトを開く

スプレッドシートから、最初の行に変数名、最初の列に行名が含まれるテーブルを作成します。

T = readtable('patients.xls','ReadRowNames',true);

テーブルの最初の 5 行と最初の 4 つの変数を表示します。

T(1:5,1:4)

ans=5×4 table
                 Gender     Age             Location              Height
                ________    ___    ___________________________    ______

    Smith       'Male'      38     'County General Hospital'        71  
    Johnson     'Male'      43     'VA Hospital'                    69  
    Williams    'Female'    38     'St. Mary's Medical Center'      64  
    Jones       'Female'    40     'VA Hospital'                    67  
    Brown       'Female'    49     'County General Hospital'        64

テーブルの DimensionNames プロパティを表示します。

T.Properties.DimensionNames

ans = 1x2 cell array
    {'LastName'}    {'Variables'}

'LastName' は、スプレッドシートの最初の行の最初の列にある名前です。

スプレッドシートからの特定範囲のデータの読み取り

スクリプトを開く

スプレッドシート patients.xls の指定した領域のデータを使用して table を作成します。角 C2 と E6 の間にある 5 行 3 列の四角形領域のデータを使用します。この領域の最初の行は変数名として使用しないでください。

T = readtable('patients.xls',...
    'Range','C2:E6',...
    'ReadVariableNames',false)

T = 

    Var1               Var2                Var3
    ____    ___________________________    ____

    38      'County General Hospital'      71  
    43      'VA Hospital'                  69  
    38      'St. Mary's Medical Center'    64  
    40      'VA Hospital'                  67  
    49      'County General Hospital'      64

T には、既定の変数名が含まれます。

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

ライブスクリプトを開く

インポートオプションを作成し、複数の変数に対しデータ型を適用してから、データを読み取ります。

テキストファイルからインポートオプションオブジェクトを作成します。

opts = detectImportOptions('airlinesmall.csv')

opts = 
  DelimitedTextImportOptions with properties:

   Format Properties:
                    Delimiter: {','}
                   Whitespace: '\b\t '
                   LineEnding: {'\n'  '\r'  '\r\n'}
                 CommentStyle: {}
    ConsecutiveDelimitersRule: 'split'
        LeadingDelimitersRule: 'keep'
                EmptyLineRule: 'skip'
                     Encoding: 'UTF-8'

   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

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

変数 TaxiIn と TaxiOut の Type プロパティを確認します。

getvaropts(opts,{'TaxiIn','TaxiOut'})

ans = 
  1x2 TextVariableImportOptions array with properties:

    WhitespaceRule
    Type
    FillValue
    Name
    QuoteRule
    TreatAsMissing
    Prefixes
    Suffixes
    EmptyFieldRule

変数 TaxiIn と TaxiOut の型を double に変更します。

 opts = setvartype(opts,{'TaxiIn','TaxiOut'},'double');

インポートして確認する変数のサブセットを指定します。

opts.SelectedVariableNames = {'TaxiIn','TaxiOut'};

関数 readtable をオプションオブジェクトと共に使用して、選択した変数をインポートします。テーブルの概要を表示します。

T = readtable('airlinesmall.csv',opts);
summary(T)

Variables:

    TaxiIn: 123523x1 double

        Values:

            Min            0      
            Median         5      
            Max            1451   
            NumMissing     37383  

    TaxiOut: 123523x1 double

        Values:

            Min             0      
            Median          13     
            Max             755    
            NumMissing      37364

スプレッドシートファイルのインポートオプションの検出と使用

ライブスクリプトを開く

スプレッドシートファイルのインポートオプションを検出し、インポートする変数を指定してから、データを読み取ります。

ファイルからインポートオプションオブジェクトを作成します。

opts = detectImportOptions('patients.xls')

opts = 
  SpreadsheetImportOptions with properties:

   Sheet Properties:
                        Sheet: ''

   Replacement Properties:
                  MissingRule: 'fill'
              ImportErrorRule: 'fill'

   Variable Import Properties: Set types by name using setvartype
                VariableNames: {'LastName', 'Gender', 'Age' ... and 7 more}
                VariableTypes: {'char', 'char', 'double' ... and 7 more}
        SelectedVariableNames: {'LastName', 'Gender', 'Age' ... and 7 more}
              VariableOptions: Show all 10 VariableOptions 
	Access VariableOptions sub-properties using setvaropts/getvaropts

   Range Properties:
                    DataRange: 'A2' (Start Cell)
           VariableNamesRange: 'A1'
                RowNamesRange: ''
           VariableUnitsRange: ''
    VariableDescriptionsRange: '' 
	To display a preview of the table, use preview

オプションオブジェクトを変更してインポートする変数を指定します。

opts.SelectedVariableNames = {'Systolic','Diastolic'};

readtable をオプションオブジェクトと共に使用して、指定した変数をインポートします。

T = readtable('patients.xls',opts);
summary(T)

Variables:

    Systolic: 100x1 double

        Values:

            Min          109    
            Median       122    
            Max          138    

    Diastolic: 100x1 double

        Values:

            Min            68    
            Median       81.5    
            Max            99

入力引数

すべて折りたたむ

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

読み取るファイルの名前。文字ベクトルまたは string スカラーとして指定します。ファイルが現在のフォルダーまたは MATLAB^® パス上のフォルダーにある場合は、ファイル名を filename で指定します。たとえば、'myFile.csv' のようになります。

filename にファイル拡張子が含まれる場合、readtable は拡張子からファイル形式を判別します。それ以外の場合は、名前と値のペアの引数 'FileType' を指定してファイルの種類を示さなければなりません。

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

場所	形式
フォルダー内のファイル	ファイルが現在のフォルダーまたは MATLAB パス上のフォルダーにない場合は、絶対パス名または相対パス名を指定します。例: `'C:\myFolder\myFile.xlsx'` 例: `'\imgDir\myFile.txt'`
リモートの場所 (Amazon S3™、Windows Azure^® Blob ストレージ、HDFS™)	リモートの場所に保存されたファイルの場合、`filename` は `scheme_name://path_to_file` の形式の IRI (国際化リソース識別子) として指定されたファイルの絶対パスを含まなければなりません。 `scheme_name` は、次のいずれかの値にできます。`s3`、`wasb`、`wasbs`、または `hdfs`。詳細については、リモートデータの操作を参照してください。例: `'s3://bucketname/path_to_file/my_file.csv'`

場所

形式

フォルダー内のファイル

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

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

例: '\imgDir\myFile.txt'

リモートの場所

(Amazon S3™、Windows Azure^® Blob ストレージ、HDFS™)

リモートの場所に保存されたファイルの場合、filename は
scheme_name://path_to_file の形式の IRI (国際化リソース識別子) として指定されたファイルの絶対パスを含まなければなりません。

scheme_name は、次のいずれかの値にできます。s3、wasb、wasbs、または hdfs。

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

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

Microsoft^® Excel^® ソフトウェアがインストールされている Windows^® システムで、readtable は使用している Excel のバージョンで認識されるすべての Excel スプレッドシートファイル形式を読み取ります。システムに Excel for Windows がない場合、または MATLAB Online™ を使用している場合、readtable は UseExcel プロパティが false に設定されている状態で動作し、.xls, .xlsx, .xlsm, .xltx, and .xltm ファイルのみを読み取ります。

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

データ型: char | string

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

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

ファイルの種類	出力
スプレッドシートファイル	`SpreadsheetImportOptions` オブジェクト
テキストファイル	`DelimitedTextImportOptions` オブジェクト
固定幅テキストファイル	`FixedWidthImportOptions` オブジェクト

名前と値のペアの引数

オプションの Name,Value の引数ペアをコンマ区切りで指定します。Name は引数名で、Value は対応する値です。Name は引用符で囲まなければなりません。Name1,Value1,...,NameN,ValueN のように、複数の名前と値のペアの引数を任意の順序で指定できます。

例: 'ReadVariableNames',false は、ファイルの最初の行が変数名に対応しないことを示します。

読み取り時は次のようになります。

テキストファイルの場合、FileType、ReadVariableNames、ReadRowNames、TreatAsEmpty、DatetimeType、Delimiter、HeaderLines、Format、EmptyValue、MultipleDelimsAsOne、CollectOutput、CommentStyle、ExpChars、EndOfLine、DateLocale および Encoding のパラメーター名のみが適用されます。
スプレッドシートファイルの場合、FileType、ReadVariableNames、ReadRowNames、TreatAsEmpty、DatetimeType、Sheet、Range、Basic および TextType のパラメーター名のみが適用されます。
opts インポートオプションをもつテキストファイルまたはスプレッドシートファイルの場合、ReadVariableNames、ReadRowNames、DateLocale、Encoding、Sheet および Basic のパラメーター名のみが適用されます。

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

すべて折りたたむ

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

ファイルの種類。'FileType' と、'text' または 'spreadsheet' を含む文字ベクトルまたは string スカラーで構成されるコンマ区切りのペアとして指定します。

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

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

例: 'FileType','text'

例: 'FileType',"text"

データ型: char | string

`'ReadVariableNames'` — 最初の行を変数名として読み取る
`true` | `false` | `1` | `0`

最初の行を変数名として読み取るかどうかを示すインジケーター。'ReadVariableNames' と、true、false、1 または 0 で構成されるコンマ区切りのペアとして指定します。指定しない場合、readtable は変数名の有無を自動的に検出します。

インジケーター	説明
`true`	読み取る領域の最初の行にテーブルの変数名が含まれている場合に使用します。`readtable` は、検出した変数名を使用して `T` の各列に変数を作成します。
`false`	読み取る領域の最初の行にテーブルのデータが含まれている場合に使用します。`readtable` は、`'Var1',...,'VarN'` の形式で既定の変数名を作成します。ここで、`N` は変数の数です。
指定なし	指定しない場合、`readtable` は `true` または `false` を自動的に検出し、それに応じて続行します。

メモ: 'ReadVariableNames' と 'ReadRowNames' の両方の論理インジケーターが true の場合、readtable は領域の最初の行の最初の列にある名前を T.Properties.DimensionNames プロパティの最初の次元の名前として読み取ります。

インポートオプションの opts に加えて引数 ReadVariableNames を指定した場合、readtable の動作が指定に基づき変化します。

ReadVariableNames が true の場合、インポートオプションオブジェクトの VariableNamesRange または VariableNamesLine プロパティを使用して、指定されたファイルから変数名を読み取ります。
ReadVariableNames が false の場合、インポートオプションオブジェクトの VariableNames プロパティから変数名を読み取ります。

`'ReadRowNames'` — 最初の列を行名として読み取るかどうかを示すインジケーター
`false` (既定値) | `true` | `0` | `1`

最初の列を行名として読み取るかどうかを示すインジケーター。'ReadRowNames' と、false、true、0 または 1 で構成されるコンマ区切りのペアとして指定します。

インジケーター	説明
`false`	読み取る領域の最初の列にテーブルの行名ではなくデータが含まれている場合に使用します。
`true`	読み取る領域の最初の列にテーブルの行名が含まれている場合に使用します。
指定なし	指定されていない場合、`readtable` は `false` と仮定します。

インポートオプションの opts に加えて引数 ReadRowNames を指定した場合、readtable の動作が指定に基づき変化します。

ReadRowNames が true の場合、インポートオプションオブジェクトの RowNamesRange または RowNameColumn プロパティを使用して、指定されたファイルから行名を読み取ります。
ReadRowNames が false の場合、行名をインポートしません。

`'TreatAsEmpty'` — 空の値として扱うプレースホルダーテキスト
文字ベクトル | 文字ベクトルの cell 配列 | 文字列 | string 配列

空の値として扱うプレースホルダーテキスト。'TreatAsEmpty' と、文字ベクトル、文字ベクトルの cell 配列、string または string 配列で構成されるコンマ区切りのペアとして指定します。これらの文字に対応する table 要素は NaN に設定されます。

'TreatAsEmpty' はファイル内の数値列にのみ適用され、readtable は '-99' のような数値リテラルを受け取りません。

例: 'TreatAsEmpty','N/A' または 'TreatAsEmpty',"N/A" は数値列内の N/A を NaN に設定します。

例: 'TreatAsEmpty',{'.','NA','N/A'} または 'TreatAsEmpty',[".","NA","N/A"] は数値列内の .、NA および N/A を NaN に設定します。

データ型: char | string

`'TextType'` — テキストの出力データ型
`'char'` (既定値) | `'string'`

テキストの出力データ型。'TextType' と、'char' または 'string' のいずれかを含む文字ベクトルまたは string スカラーで構成されるコンマ区切りのペアとして指定します。値 'char' を指定した場合、readtable はテキストを文字ベクトルの cell 配列として返します。値 'string' を指定した場合、readtable はテキストを string 型の配列として返します。

データ型: char | string

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

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

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

値	インポートされる日付と時刻のデータの型
`'datetime'`	MATLAB の `datetime` データ型詳細については、`datetime` を参照してください。
`'text'`	`'DatetimeType'` を `'text'` として指定した場合、インポートされる日付と時刻のデータの型は `'TextType'` パラメーターで指定された値によって決まります。 `'TextType'` が `'char'` の場合、`readtable` は日付を文字ベクトルの cell 配列として返します。 `'TextType'` が `'string'` の場合、`readtable` は日付を string の配列として返します。
`'exceldatenum'`	Excel のシリアル日付値シリアル日付値は、指定された基準日からの日数に等しい単一の数値です。Excel のシリアル日付値では MATLAB のシリアル日付値とは異なる基準日が使用されています。Excel の日付の詳細については、`https://support.microsoft.com/en-us/kb/214330` を参照してください。

'datetime'

MATLAB の datetime データ型

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

'text'

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

'TextType' が 'char' の場合、readtable は日付を文字ベクトルの cell 配列として返します。
'TextType' が 'string' の場合、readtable は日付を string の配列として返します。

'exceldatenum'

Excel のシリアル日付値

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

例: 'DatetimeType','text'

例: 'DatetimeType',"datetime"

データ型: char | string

テキストファイルのみ

すべて折りたたむ

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

フィールドの区切り記号。'Delimiter' と文字ベクトル、文字ベクトルの cell 配列、または string で構成されるコンマ区切りのペアとして指定します。Delimiter は、コンマ ',' やピリオド '.' などの有効な文字を使用して指定します。

次の表は、一般的に使用されるフィールドの区切り記号の一部を示しています。

指定子	フィールドの区切り記号
`','` `'comma'`	コンマ
`' '` `'space'`	スペース
`'\t'` `'tab'`	タブ
`';'` `'semi'`	セミコロン
`'\|'` `'bar'`	縦棒
指定なし	指定されていない場合、`readtable` は区切り記号を自動的に検出します。

連続する区切り記号を 1 つの区切り記号として扱うには、Delimiter を文字ベクトルの cell 配列として指定します。さらに、MultipleDelimsAsOne オプションも指定しなければなりません。

例: 'Delimiter',',' または 'Delimiter','comma'

データ型: char | string | cell

`'HeaderLines'` — スキップする行
正の整数

ファイルの先頭でスキップする行。'HeaderLines' と正の整数で構成されるコンマ区切りのペアとして指定します。指定しない場合、readtable はスキップする行数を自動的に検出します。

データ型: single | double

`'Format'` — 列の形式
文字ベクトル | string

ファイルの列の形式。'Format' と 1 つ以上の変換指定子の文字ベクトルまたは string スカラーで構成されるコンマ区切りのペアとして指定します。変換指定子は、関数 textscan が受け入れる指定子と同じです。

形式を指定すると、大きなファイルの速度が大幅に高速化する場合があります。Format に値を指定しない場合、readtable は %q を使用して非数値の列を解釈します。%q 指定子はテキストを読み取り、必要に応じて二重引用符 (") を除外します。

既定では、作成される変数は、データに応じて double または文字ベクトルの cell 配列のいずれかです。列全体が数値の場合、変数は double としてインポートされます。列に数値ではない要素が含まれる場合、変数は文字ベクトルの cell 配列としてインポートされます。

データ型: char | string

`'EmptyValue'` — 空の数値フィールドに返す値
`NaN` (既定値) | スカラー

区切り付きテキストファイルの空の数値フィールドに返す値は、'EmptyValue' およびスカラーで構成されるコンマ区切りのペアとして指定します。

`'MultipleDelimsAsOne'` — 複数の区切り記号の取り扱い
`0 (false)` (既定値) | `1 (true)`

複数の区切り記号の取り扱いは、'MultipleDelimsAsOne' と true または false で構成されるコンマ区切りのペアとして指定します。true の場合、インポート関数は連続した区切り記号を 1 つの区切り記号として扱います。区切り記号が空白で分けられて繰り返された場合も、1 つの区切り記号として扱われます。Delimiter オプションも指定しなければなりません。

例: 'MultipleDelimsAsOne',1

`'CollectOutput'` — データ連結を決定する論理インジケーター
`false` (既定値) | `true`

データ連結を決定する論理インジケーターは、'CollectOutput' と、true または false とで構成されるコンマ区切りのペアとして指定します。true の場合、インポート関数は同じ基本 MATLAB クラスの連続する出力セルを連結して 1 つの配列にします。

`'CommentStyle'` — 無視するテキストを示す記号
文字ベクトル | 文字ベクトルの cell 配列 | 文字列 | string 配列

無視するテキストを示す記号。'CommentStyle' と、文字ベクトル、文字ベクトルの cell 配列、string、または string 配列で構成されるコンマ区切りのペアとして指定します。

たとえば、'%' などの文字を指定して、同じ行でその記号の後に続くテキストを無視します。{'/*','*/'} のように 2 つの文字ベクトルの cell 配列を指定して、それらのシーケンスの間にあるすべてのテキストを無視します。

MATLAB は、各フィールドの最初にだけコメントをチェックします (フィールド内はコメントチェック対象外です)。

例: 'CommentStyle',{'/*','*/'}

データ型: char | string

`'ExpChars'` — 指数文字
`'eEdD'` (既定値) | 文字ベクトル | 文字列

指数文字。'ExpChars' と文字ベクトルまたは string で構成されるコンマ区切りのペアとして指定します。既定の指数文字は e、E、d および D です。

データ型: char | string

`'EndOfLine'` — 行末の文字
文字ベクトル | 文字列

行末の文字。'EndOfLine' と文字ベクトルまたは string で構成されるコンマ区切りのペアとして指定します。文字ベクトルは '\r\n' であるか、単一の文字を指定しなければなりません。一般的な行末文字としては、改行文字 ('\n') やキャリッジリターン ('\r') があります。'\r\n' を指定すると、インポート関数は \r、\n、その 2 つの組み合わせ (\r\n) をすべて行末文字として扱います。

既定の行末シーケンスは \n、\r または \r\n のいずれかで、ファイルの内容によって異なります。

ファイルの最後の行の末尾に欠損値および行末シーケンスが存在する場合、インポート関数はそれらのフィールドに空の値を返します。これにより、出力 cell 配列 C 内の個々のセルが確実に同じサイズになります。

例: 'EndOfLine',':'

データ型: char | string

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

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

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

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

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

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

例: 'DateLocale','ja_JP'

例: 'DateLocale',"ja_JP"

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

ファイルに関連付けられた文字エンコードスキーム。'Encoding' と 'system' で構成されるコンマ区切りのペア、または次の表に示す値のいずれかのような標準の文字エンコードスキーム名として指定します。エンコードを指定しない場合、またはエンコードを 'system' として指定した場合は、関数 readtable はシステムの既定のエンコードを使用してファイルを読み取ります。

`'Big5'`	`'ISO-8859-1'`	`'windows-847'`
`'Big5-HKSCS'`	`'ISO-8859-2'`	`'windows-949'`
`'CP949'`	`'ISO-8859-3'`	`'windows-1250'`
`'EUC-KR'`	`'ISO-8859-4'`	`'windows-1251'`
`'EUC-JP'`	`'ISO-8859-5'`	`'windows-1252'`
`'EUC-TW'`	`'ISO-8859-6'`	`'windows-1253'`
`'GB18030'`	`'ISO-8859-7'`	`'windows-1254'`
`'GB2312'`	`'ISO-8859-8'`	`'windows-1255'`
`'GBK'`	`'ISO-8859-9'`	`'windows-1256'`
`'IBM866'`	`'ISO-8859-11'`	`'windows-1257'`
`'KOI8-R'`	`'ISO-8859-13'`	`'windows-1258'`
`'KOI8-U'`	`'ISO-8859-15'`	`'US-ASCII'`
	`'Macintosh'`	`'UTF-8'`
	`'Shift_JIS'`

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

例: 'Encoding', 'UTF-8'

例: "Encoding", "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

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

すべて折りたたむ

`'Sheet'` — 読み取るワークシート
`1` (既定値) | 正の整数 | 文字ベクトル | 文字列

読み取るワークシート。'Sheet' と、ワークシートインデックスを示す正の整数またはワークシート名を含む文字ベクトルまたは string で構成されるコンマ区切りのペアとして指定します。ワークシート名にコロン (:) を含めることはできません。スプレッドシートファイルのシートの名前を決めるには、[status,sheets] = xlsfinfo(filename) を使用します。詳細については、xlsfinfo を参照してください。

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

例: 'Sheet', 2

例: 'Sheet', 'MySheetName'

例: 'Sheet', "MySheetName"

`'Range'` — ワークシートの読み取り対象部分
文字ベクトル | string スカラー

ワークシートの読み取り対象部分。'Range' と次のいずれかの形式の文字ベクトルまたは string スカラーで構成されるコンマ区切りのペアで四角形の領域として指定します。

Range の指定方法説明

`Range` の指定方法	説明
`'Corner1:Corner2'` 四角形の範囲	構文 `'Corner1:Corner2'` を使用して範囲を指定します。`Corner1` と `Corner2` は、領域を定義する 2 つの対角です。たとえば、`'D2:H4'` は、ワークシート上の 2 つの角 `D2` と `H4` の間にある 3 行 5 列の四角形領域を表します。名前と値のペアの引数 `'Range'` では大文字小文字は区別されず、Excel A1 参照スタイル (Excel ヘルプを参照) が使用されます。例: `'Range','Corner1:Corner2'`
`''` 指定なしまたは空	指定しない場合、`readtable` は使用範囲を自動的に検出します。例: `'Range',''` メモ: "使用範囲" とは、スプレッドシート内の実際にデータを含んでいる四角形部分を指します。`readtable` は、データを含んでいない前後の行と列をすべてトリミングすることで、使用範囲を自動的に検出します。空白のみのテキストはデータと見なされ、使用範囲内に取得されます。
`'Row1:Row2'` 行範囲	Excel の行指定子によって開始行と終了行を指定して、行の範囲を表すことができます。これにより、`readtable` は指定された行内で列の使用範囲を自動的に検出します。たとえば、`readtable` は範囲指定 `'1:7'` を、1 ～ 7 行目の使用範囲にあるすべての列を読み取る命令として解釈します。例: `'Range','1:7'`
`'Column1:Column2'` 列範囲	Excel の列指定子を使用して開始列と終了列を指定することで、範囲を表すことができます。これにより、`readtable` は指定された列内で行の使用範囲を自動的に検出します。たとえば、`readtable` は範囲指定 `'A:F'` を、A ～ F 列の使用範囲にあるすべての行を読み取る命令として解釈します。例: `'Range','A:F'`
`'NamedRange'` Excel の名前付き範囲	Excel では、スプレッドシート内の範囲を表す名前を作成できます。たとえば、スプレッドシートの四角形部分を選択して `'myTable'` という名前を付けることができます。スプレッドシート内にそのような名前付き範囲が存在する場合、`readtable` はその名前を使用して範囲を読み取ることができます。例: `'Range','myTable'`

'Corner1:Corner2'

四角形の範囲

構文 'Corner1:Corner2' を使用して範囲を指定します。Corner1 と Corner2 は、領域を定義する 2 つの対角です。たとえば、'D2:H4' は、ワークシート上の 2 つの角 D2 と H4 の間にある 3 行 5 列の四角形領域を表します。名前と値のペアの引数 'Range' では大文字小文字は区別されず、Excel A1 参照スタイル (Excel ヘルプを参照) が使用されます。

例: 'Range','Corner1:Corner2'

''

指定なしまたは空

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

例: 'Range',''

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

'Row1:Row2'

行範囲

Excel の行指定子によって開始行と終了行を指定して、行の範囲を表すことができます。これにより、readtable は指定された行内で列の使用範囲を自動的に検出します。たとえば、readtable は範囲指定 '1:7' を、1 ～ 7 行目の使用範囲にあるすべての列を読み取る命令として解釈します。

例: 'Range','1:7'

'Column1:Column2'

列範囲

Excel の列指定子を使用して開始列と終了列を指定することで、範囲を表すことができます。これにより、readtable は指定された列内で行の使用範囲を自動的に検出します。たとえば、readtable は範囲指定 'A:F' を、A ～ F 列の使用範囲にあるすべての行を読み取る命令として解釈します。

例: 'Range','A:F'

'NamedRange'

Excel の名前付き範囲

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

例: 'Range','myTable'

例: 'Range', 'A1:F10'

例: 'Range', "A1:F10"

データ型: char | string

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

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

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

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

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

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

出力引数

すべて折りたたむ

`T` — 出力テーブル
テーブル

テーブルとして返される出力テーブル。テーブルには、説明、変数単位、変数名、行名などのメタデータを保存できます。詳細については、table のプロパティの節を参照してください。

ヒント

XLSX 形式の大きなファイルは読み取りに時間がかかることがあります。インポートとエクスポートのパフォーマンスを向上させるためには、XLSB 形式を使用することが Microsoft によって推奨されています。

参考

readtable

構文

説明

例

テキスト ファイルからのテーブルの作成

テキスト ファイルからの列見出しのないテーブルの作成

テキスト ファイルからのテーブルの作成と形式の設定

テキスト ファイルからの外国語の日付の読み取り

スプレッドシートからの行名を含むテーブルの作成

スプレッドシートからの特定範囲のデータの読み取り

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

スプレッドシート ファイルのインポート オプションの検出と使用

入力引数

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

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

名前と値のペアの引数

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

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

'ReadVariableNames' — 最初の行を変数名として読み取る true | false | 1 | 0

'ReadRowNames' — 最初の列を行名として読み取るかどうかを示すインジケーター false (既定値) | true | 0 | 1

'TreatAsEmpty' — 空の値として扱うプレースホルダー テキスト 文字ベクトル | 文字ベクトルの cell 配列 | 文字列 | string 配列

'TextType' — テキストの出力データ型 'char' (既定値) | 'string'

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

テキスト ファイルのみ

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

'HeaderLines' — スキップする行 正の整数

'Format' — 列の形式 文字ベクトル | string

'EmptyValue' — 空の数値フィールドに返す値 NaN (既定値) | スカラー

'MultipleDelimsAsOne' — 複数の区切り記号の取り扱い 0 (false) (既定値) | 1 (true)

'CollectOutput' — データ連結を決定する論理インジケーター false (既定値) | true

'CommentStyle' — 無視するテキストを示す記号 文字ベクトル | 文字ベクトルの cell 配列 | 文字列 | string 配列

'ExpChars' — 指数文字 'eEdD' (既定値) | 文字ベクトル | 文字列

'EndOfLine' — 行末の文字 文字ベクトル | 文字列

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

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

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

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

'Sheet' — 読み取るワークシート 1 (既定値) | 正の整数 | 文字ベクトル | 文字列

'Range' — ワークシートの読み取り対象部分 文字ベクトル | string スカラー

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

出力引数

T — 出力テーブル テーブル

ヒント

参考

トピック

R2013b で導入

MATLAB ドキュメンテーション

サポート

MATLABで始めるディープラーニング

テキストファイルからのテーブルの作成

テキストファイルからの列見出しのないテーブルの作成

テキストファイルからのテーブルの作成と形式の設定

テキストファイルからの外国語の日付の読み取り

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

スプレッドシートファイルのインポートオプションの検出と使用

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

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

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

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

`'ReadVariableNames'` — 最初の行を変数名として読み取る
`true` | `false` | `1` | `0`

`'ReadRowNames'` — 最初の列を行名として読み取るかどうかを示すインジケーター
`false` (既定値) | `true` | `0` | `1`

`'TreatAsEmpty'` — 空の値として扱うプレースホルダーテキスト
文字ベクトル | 文字ベクトルの cell 配列 | 文字列 | string 配列

`'TextType'` — テキストの出力データ型
`'char'` (既定値) | `'string'`

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

テキストファイルのみ

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

`'HeaderLines'` — スキップする行
正の整数

`'Format'` — 列の形式
文字ベクトル | string

`'EmptyValue'` — 空の数値フィールドに返す値
`NaN` (既定値) | スカラー

`'MultipleDelimsAsOne'` — 複数の区切り記号の取り扱い
`0 (false)` (既定値) | `1 (true)`

`'CollectOutput'` — データ連結を決定する論理インジケーター
`false` (既定値) | `true`

`'CommentStyle'` — 無視するテキストを示す記号
文字ベクトル | 文字ベクトルの cell 配列 | 文字列 | string 配列

`'ExpChars'` — 指数文字
`'eEdD'` (既定値) | 文字ベクトル | 文字列

`'EndOfLine'` — 行末の文字
文字ベクトル | 文字列

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

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

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

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

`'Sheet'` — 読み取るワークシート
`1` (既定値) | 正の整数 | 文字ベクトル | 文字列

`'Range'` — ワークシートの読み取り対象部分
文字ベクトル | string スカラー

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

`T` — 出力テーブル
テーブル