Main Content

本页对应的英文页面已更新,但尚未翻译。 若要查看最新内容,请点击此处访问英文页面。

preview

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

说明

示例

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

  • 导入选项对象 optsSelectedVariableNames 属性值用于选择出现在表 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

输入参数

全部折叠

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

示例: 'myFile.xlsx'

数据类型: char | string

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

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

算法

  • 在下列情况下,preview 函数返回的行数少于八行:

    • 当文件包含的数据少于八行时。

    • opts 对象的 DataLinesDataRange 属性指定的数据少于八行时。

    • opts 对象的属性组合导致数据少于八行时。例如,当 opts 对象的 EmptyLineRuleImportErrorRuleMissingRule 的值导致导入函数忽略数据时,preview 返回的数据少于八行。

  • 如果 opts 对象的 DataLinesDataRange 属性指定多个行范围,而第一个行范围少于八行,则 preview 先返回第一个行范围的行,然后返回第二个行范围的行,以此类推,直到总行数达到八行为止。

在 R2018a 中推出