preview

インポート オプションを使用してファイルから 8 行をプレビュー

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

構文

T = preview(filename,opts)

説明

T = preview(filename,opts) はインポート オプション opts を使用して filename 内のデータのうち、最初の 8 行を含む table を返します。

  • インポート オプション オブジェクト opts の SelectedVariableNames プロパティの値は、table T に表示される変数を選択します。

  • 関数 preview は、関数 readtable がインポート オプション オブジェクト opts で返すデータのサブセットを返します。

  • 通常、関数 preview の出力にはデータの 8 行が含まれています。ただし、一部のインスタンスでは、インポート オプション オブジェクト opts で定義されたプロパティ値に応じて行数が異なります。詳細については、ヒントを参照してください。

例

例

すべて折りたたむ

ライブ スクリプトを開く

最初に、インポート オプション オブジェクトを作成します。次に、インポート オプションを使用して table の最初の 8 行を取得してから、対象とする変数のみが表示されるプレビューを生成します。

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

filename = 'outages.csv';
opts = detectImportOptions(filename);

table をプレビューします。

preview(filename,opts)
ans=8×6 table
      Region            OutageTime          Loss     Customers       RestorationTime             Cause      
    ___________    ____________________    ______    __________    ____________________    _________________

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

プレビューに含める変数と読み取り操作を選択します。

opts.SelectedVariableNames = {'Region','OutageTime'};

最初の 8 行と選択した変数をプレビューします。

preview(filename,opts)
ans=8×2 table
      Region            OutageTime     
    ___________    ____________________

    'SouthWest'    01-Feb-2002 12:18:00
    'SouthEast'    23-Jan-2003 00:49:00
    'SouthEast'    07-Feb-2003 21:15:00
    'West'         06-Apr-2004 05:44:00
    'MidWest'      16-Mar-2002 06:18:00
    'West'         18-Jun-2003 02:49:00
    'West'         20-Jun-2004 14:39:00
    'West'         06-Jun-2002 19:28:00

入力引数

すべて折りたたむ

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

例: 'myFile.xlsx'

データ型: char | string

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

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

アルゴリズム

  • 関数 preview は、次の場合に 8 行未満を返します。

    • ファイルに 8 行未満のデータが含まれる場合。

    • opts オブジェクトの DataLines プロパティまたは DataRange プロパティで 8 行未満を指定した場合。

    • opts オブジェクトのプロパティを組み合わせた結果データが 8 行未満になった場合。たとえば、opts オブジェクトの EmptyLineRule、ImportErrorRule または MissingRule の値によってインポート関数がデータを省略する場合、preview は 8 行未満を返します。

  • opts オブジェクトの DataLines プロパティまたは DataRange プロパティが複数行の範囲を指定し、最初の行範囲が 8 行未満にわたっている場合、preview は最初の行範囲から行を返した後、全 8 行に達するまで連続する行を返します。

バージョン履歴

R2018a で導入

参考

| | | |