preview

使用导入选项预览文件中的八行数据

全页折叠

语法

T = preview(filename,opts)

说明

T = preview(filename,opts) 使用导入选项 opts 返回包含 filename 中前八行数据的表。

导入选项对象 opts 的 SelectedVariableNames 属性值用于选择出现在表 T 中的变量。
预览函数返回 readtable 函数使用导入选项对象 opts 所返回的数据子集。
通常，preview 函数的输出包含八行数据。但是在某些情况下，行数根据导入选项对象 opts 中定义的属性值而不同。有关详细信息，请参阅提示。

示例

全部折叠

在导入完整表格之前预览数据

打开实时脚本

首先创建一个导入选项对象。接下来，使用导入选项获取表格的前八行，然后生成预览，只显示感兴趣的变量。

为文件创建导入选项对象。

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

预览表格。

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'};

预览前八行和所选变量。

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

输入参数

全部折叠

`filename` — 要读取的文件的名称
字符向量 | 字符串标量

要读取的文件的名称，指定为字符向量或字符串标量。

示例: 'myFile.xlsx'

数据类型: char | string

`opts` — 文件导入选项
`SpreadsheetImportOptions` | `DelimitedtextImportOptions` | `FixedWidthImportOptions`

文件导入选项，指定为 detectImportOptions 函数创建的 SpreadsheetImportOptions、DelimitedTextImportOptions 或 FixedWidthImportOptions 对象。opts 对象包含控制数据导入过程的属性。有关各对象的属性的详细信息，请参阅相应的对象页面。

文件类型	输出
电子表格文件	`SpreadsheetImportOptions` 对象
文本文件	`DelimitedTextImportOptions` 对象
等宽文本文件	`FixedWidthImportOptions` 对象

算法

在下列情况下，preview 函数返回的行数少于八行：
- 当文件包含的数据少于八行时。
- 当 opts 对象的 DataLines 或 DataRange 属性指定的数据少于八行时。
- 当 opts 对象的属性组合导致数据少于八行时。例如，当 opts 对象的 EmptyLineRule、ImportErrorRule 或 MissingRule 的值导致导入函数忽略数据时，preview 返回的数据少于八行。