预览

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

折叠所有页面

语法

T =预览(文件名，opts)

描述

例子

T=预览(文件名，选择）返回包含中前八行的数据的表文件名，使用导入选项选择．

的值SelectedVariableNames导入选项对象的属性选择选择表中出现的变量T．
预览函数返回数据的子集readtable函数返回导入选项对象选择．
通常，输出的预览函数包含8行数据。但是，在某些情况下，行数取决于import options对象中定义的属性值选择．欲了解更多详情，提示．

例子

全部折叠

导入全表前预览数据

打开实时脚本

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

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

文件名=“outages.csv”；opts = detectImportOptions(文件名);

预览表格。

预览(文件名,选择)

ans =8×6表区域OutageTime损失客户恢复时间原因___________ ____________________ ________________ ____________________ _________________ '西南' 01-Feb-2002 12:18:00 1.8202e+06 07-Feb-2002 16:50:00 '冬季风暴' '东南' 2003年1月23日00:49:00 530.14 2.1204e+05 NaT '冬季风暴' '东南' 07-Feb-2003 21:15:00 289.4 1.4294e+05 17-Feb-2003 08:14:00 '冬季风暴' '西部' 06- 04 -2004 05:44:00 434.81 3.4037e+05 06- 04 -2004 06:10:00 '设备故障' '中西部' 2002年3月16日06:18:00 186.44 2.1275e+05 2002年3月18日23:23:00“严重风暴”“西”2003年6月18日02:49:00 00 2003年6月18日10:54:00“攻击”“西”2004年6月20日14:39:00 231.29 NaN 20-Jun-2004年19:16:00“设备故障”“西”06-Jun-2002年19:28:00 311.86 NaN 07-Jun-2002年00:51:00“设备故障”

选择要包含在预览和读取操作中的变量。

选择。SelectedVariableNames = {“地区”，“OutageTime”}；

预览前八行和选定的变量。

预览(文件名,选择)

ans =8×2表区域OutageTime ___________ ____________________ '西南' 01-Feb-2002 12:18:00 '东南' 23- january -2003 00:49:00 '东南' 07-Feb-2003 21:15:00 '西' 06-Apr-2004 05:44:00 '中西部' 16- march -2002 06:18:00 '西' 18- june -2003 02:49:00 '西' 20- june -2004 14:39:00 '西' 06- june -2002 19:28:00

输入参数

全部折叠

`文件名`- - - - - -要读取的文件名称
特征向量|字符串标量

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

例子:“myFile.xlsx”

数据类型:字符|字符串

`选择`- - - - - -文件导入选项
`SpreadsheetImportOptions`|`DelimitedtextImportOptions`|`FixedWidthImportOptions`

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

文件类型	输出
电子表格文件	`SpreadsheetImportOptions`对象
文本文件	`DelimitedTextImportOptions`对象
固定宽度的文本文件	`FixedWidthImportOptions`对象

算法

的预览函数在以下情况下返回少于8行:
- 当文件包含的数据少于8行时。
- 当DataLines或者是DataRange的属性选择对象指定少于8行。
- 当一种属性的组合选择对象生成的数据少于8行。例如,预览属性的值时返回小于8行EmptyLineRule，ImportErrorRule或者是MissingRule的选择对象导致导入函数忽略数据。