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
    'SouthWest'    01-Feb-2002 12:18:00    458.9772    1.8202e+06    07-Feb-2002 16:50:00       'winter storm'
    'SouthEast'    23-Jan-2003 00:49:00    530.1399    2.1204e+05                     NaT       'winter storm'
    'SouthEast'    07-Feb-2003 21:15:00    289.4035    1.4294e+05    17-Feb-2003 08:14:00       'winter storm'
         'West'    06-Apr-2004 05:44:00    434.8054    3.4037e+05    06-Apr-2004 06:10:00    'equipment fault'
      'MidWest'    16-Mar-2002 06:18:00    186.4368    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.2947           NaN    20-Jun-2004 19:16:00    'equipment fault'
         'West'    06-Jun-2002 19:28:00    311.8607           NaN    07-Jun-2002 00:51:00    'equipment fault'

选择要预览和读取的变量。

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

预览前八行和所选变量。

preview(filename,opts)
ans=8×2 table
    '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 函数创建的 SpreadsheetImportOptions、DelimitedTextImportOptions 或 FixedWidthImportOptions 对象。opts 对象包含控制数据导入过程的属性。有关各对象的属性的详细信息，请参阅相应的对象页面。

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

算法

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

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

    • 当 opts 对象的 DataLines 或 DataRange 属性指定的数据少于八行时。

    • 当 opts 对象的属性组合导致数据少于八行时。例如，当 opts 对象的 EmptyLineRule、ImportErrorRule 或 MissingRule 的值导致导入函数忽略数据时，preview 返回的数据少于八行。

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

版本历史记录

在 R2018a 中推出

另请参阅

| | | |