delimitedTextImportOptions

进口为分隔文本选择对象

扩展所有的页面

描述

一个DelimitedTextImportOptions对象允许您指定如何MATLAB^®进口表格数据来自分隔的文本文件。对象包含属性控制数据导入过程,包括错误和缺失数据的处理。

创建

您可以创建一个DelimitedTextImportOptions对象使用detectImportOptions函数或delimitedTextImportOptions函数(这里描述):

使用detectImportOptions检测和填充进口属性根据指定分隔的文本文件的内容文件名。
```
选择= detectImportOptions(文件名);
```
使用delimitedTextImportOptions定义导入属性基于您的进口需求。

语法

选择= delimitedTextImportOptions

选择= delimitedTextImportOptions (NumVariables, numVars)

选择= delimitedTextImportOptions (___、名称、值)

描述

例子

选择= delimitedTextImportOptions创建一个DelimitedTextImportOptions对象的一个变量。

例子

选择= delimitedTextImportOptions (“NumVariables”,numVars)创建的对象中指定的变量numVars。

例子

选择= delimitedTextImportOptions (___,名称,值)指定附加的属性为DelimitedTextImportOptions使用一个或多个名称-值对参数对象。

输入参数

全部展开

`numVars`- - - - - -数量的变量
积极的标量整数

变量的数量,指定为一个积极的标量整数。

属性

全部展开

变量的属性

`VariableNames`- - - - - -变量名
单元阵列的特征向量|字符串数组

变量名称,指定为特征向量的细胞数组或字符串数组。的VariableNames属性包含要使用的名称在导入变量。

如果数据包含N变量,但没有指定变量名称,那么VariableNames属性包含{‘Var1’,‘Var2’,……,“VarN”}。

支持无金宝app效MATLAB标识符作为变量名,如变量名称包含空格和非ascii字符,设置的值VariableNamingRule来“保存”。

例子:opts.VariableNames返回当前(发现)变量名。

例子:opts.VariableNames(3) ={“高度”}改变第三变量的名称高度。

数据类型:字符|字符串|细胞

`VariableNamingRule`- - - - - -国旗保存变量名
`“修改”`(默认)|`“保存”`

国旗保存变量名称,指定为“修改”或“保存”。

“修改”——转换无效变量名(如决定的isvarnameMATLAB函数)来有效的标识符。
“保存”——保存变量名是无效的MATLAB标识符,如变量名,包括空间和非ascii字符。

从R2019b,变量名和行名称可以包含任何字符,包括空格和非ascii字符。同时,他们不仅可以从任何字符,字母。变量和行名称不需要有效的MATLAB标识符(如决定的isvarname功能)。保存这些变量名和行名称,设置的值VariableNamingRule来“保存”。变量名不刷新时的价值VariableNamingRule改变从“修改”来“保存”。

数据类型:字符|字符串

`VariableTypes`- - - - - -数据类型的变量
单元阵列的特征向量|字符串数组

指定数据类型的变量,作为一个单元阵列的特征向量,或字符串数组包含一组有效数据类型名称。的VariableTypes属性指定的数据类型使用在导入变量。

更新VariableTypes属性,使用setvartype函数。

例子:opts.VariableTypes返回当前变量的数据类型。

例子:选择= setvartype(选择“高度”,{“双重”})改变变量的数据类型高度来双。

`SelectedVariableNames`- - - - - -变量的子集导入
特征向量|字符串标量|单元阵列的特征向量|字符串数组|数组的数值指标

进口的变量子集,指定为一个特征向量,字符串标量,单元阵列的特征向量,字符串数组或数组的数值指标。

SelectedVariableNames必须的一个子集名称中包含VariableNames财产。默认情况下,SelectedVariableNames包含所有的变量名VariableNames属性,这意味着所有的变量都是进口的。

使用SelectedVariableNames只财产进口感兴趣的变量。指定变量使用的一个子集SelectedVariableNames属性和使用readtable进口子集。

支持无金宝app效MATLAB标识符作为变量名,如变量名称包含空格和非ascii字符,设置的值VariableNamingRule来“保存”。

例子:选择。SelectedVariableNames ={“高度”,“姓”}选择只有两个变量,高度和姓导入操作。

例子:选择。SelectedVariableNames = (1 - 5)只选择两个变量,第一个变量和第五个变量,导入操作。

例子:T = readtable(文件名,选择)返回一个表只包含中指定的变量SelectedVariableNames财产的选择对象。

数据类型:uint16|uint32|uint64|字符|字符串|细胞

`VariableOptions`- - - - - -类型特定的变量导入选项
对象数组的变量导入选项

类型特定的变量导入选项,作为一个变量导入选项对象数组返回。该数组包含一个对象对应于每个变量中指定VariableNames财产。每个对象数组中包含属性,支持数据的导入与特定的数据类型。金宝app

变量选择支持这些数据类型:数字、文金宝app本、逻辑,datetime,或分类。

查询当前(或发现)选择一个变量,使用getvaropts函数。

为一个变量设置和定制选项,使用setvaropts函数。

例子:opts.VariableOptions返回的集合VariableImportOptions对象,一个对应于每个变量的数据。

例子:getvaropts(选择“高”)返回VariableImportOptions对象的高度变量。

例子:选择= setvaropts(选择、“高度”、“FillValue”, 0)设置FillValue属性为变量高度来0。

位置属性

`DataLines`- - - - - -数据位置
积极的标量整数|积极的标量的整型数组

数据位置,指定为一个积极的标量整数或一个N -通过2积极的标量的整型数组。指定DataLines使用这些形式之一。

指定为	描述
`n`	指定第一行包含数据。指定该值使用`n`设置的值`DataLines`财产`(n正)`。导入函数读取之间的所有行`n`和文件尾。 `n`必须是一个正整数大于零。
`(n1 n2)`	指定线范围包含数据。`n1`是包含数据和第一行吗`n2`是最后一行,它包含数据。数组中的值`(n1 n2)`必须非零正整数吗`n2`必须大于`n1`。
`(n1 n2;n3陶瓷;……)`	指定多个线范围读的`N -`通过`2`数组包含`N`不同的行范围。一系列有效的多个线范围必须: 指定行范围越来越顺序,第一行数组中指定的范围出现在文件在其他行范围。只包含不重叠的范围。当指定多个线范围,使用`正`只有当指定数组中最后一行的结束。例如,`[1 3;5 6;8正)`。

指定为

描述

n

指定第一行包含数据。指定该值使用n设置的值DataLines财产(n正)。导入函数读取之间的所有行n和文件尾。

n必须是一个正整数大于零。

(n1 n2)

指定线范围包含数据。n1是包含数据和第一行吗n2是最后一行,它包含数据。

数组中的值(n1 n2)必须非零正整数吗n2必须大于n1。

(n1 n2;n3陶瓷;……)

指定多个线范围读的N -通过2数组包含N不同的行范围。

一系列有效的多个线范围必须:

指定行范围越来越顺序,第一行数组中指定的范围出现在文件在其他行范围。
只包含不重叠的范围。

当指定多个线范围,使用正只有当指定数组中最后一行的结束。例如,[1 3;5 6;8正)。

例子:选择。DataLines = 5设置DataLines属性的值(5正)。从行开始阅读所有行数据5到文件尾。

例子:选择。DataLines = [2 - 6]将属性设置为读行2通过6。

例子:选择。DataLines = [1 3;5 6;8正)将属性设置为读行1,2,3,5,6和之间的所有行8和文件尾。

`RowNamesColumn`- - - - - -行名称位置
`0`(默认)|积极的标量整数

行名称位置,指定为一个积极的标量整数。的RowNamesColumn属性指定的位置列包含行名称。

如果RowNamesColumn被指定为0,那么不要导入行名称。否则,导入行名字从指定的列。

例子:选择。RowNamesColumn = 2;

`VariableNamesLine`- - - - - -变量名的位置
`0`(默认)|积极的标量整数

变量名的位置,指定为一个积极的标量整数。的VariableNamesLine属性指定变量名所在的行号。

如果VariableNamesLine被指定为0,那么不要导入变量名。否则,导入从指定行变量名。

例子:opts.VariableNamesLine = 6;

`VariableDescriptionsLine`- - - - - -变量描述位置
`0`(默认)|积极的标量整数

变量描述位置,指定为一个积极的标量整数。的VariableDescriptionsLine属性指定变量描述所在的行号。

如果VariableDescriptionsLine被指定为0,那么不要导入变量描述。否则,从指定行导入变量描述。

例子:选择。VariableDescriptionsLine = 7;

`VariableUnitsLine`- - - - - -变量单位位置
`0`(默认)|积极的标量整数

变量单位位置、指定为一个积极的标量整数。的VariableUnitsLine属性指定变量单位所在的行号。

如果VariableUnitsLine被指定为0,那么不要导入变量单位。否则,导入变量单位从指定行。

例子:选择。VariableUnitsLine = 8;

分隔的文本属性

`分隔符`- - - - - -字段分隔符字符
字符串数组|特征向量|单元阵列的特征向量

字段分隔符字符分隔的文本文件,指定为一个字符串数组,特征向量,或单元阵列特征向量。

例子:“分隔符”、“|”

例子:“分隔符”,(“;”,“*”)

`空格`- - - - - -空格字符来治疗
特征向量|字符串标量

字符视为空白,指定为一个特征向量包含一个或多个字符或字符串标量。

例子:“空白”、“_”

例子:“空白”、“? !”

`LineEnding`- - - - - -行尾字符
`[" \ n "、" \ r”,“\ r \ n”)`(默认)|字符串数组|特征向量|单元阵列的特征向量

行尾字符,指定为一个字符串数组,特征向量,或单元阵列特征向量。

例子:“LineEnding”、“\ n”

例子:“LineEnding”、“\ r \ n”

例子:“LineEnding”(“\ b”,“:”)

`CommentStyle`- - - - - -风格的评论
字符串数组|特征向量|单元阵列的特征向量

风格的评论,指定为一个字符串数组,特征向量,或单元阵列特征向量。单和多行注释,起始标识符必须是第一个非空白字符。对于单行注释,指定一个标识符将线从标识符作为评论。多行注释,台词开始(第一)标识符结束(秒)标识符被当作注释。不超过两个特征向量的标识符可以指定。

例如,忽略线百分之一符号作为第一个非空白字符后,指定CommentStyle作为“%”。

例子:“CommentStyle”(“/ *”)

例子:“CommentStyle”(“/ *”、“* /”)

`ConsecutiveDelimitersRule`- - - - - -过程管理连续分隔符
`“分裂”`|`“加入”`|`“错误”`

过程管理连续分隔符分隔的文本文件,指定为这个表中的值之一。

价值	行为
`“分裂”`	将连续分隔符分割为多个字段。
`“加入”`	加入分隔符为一个分隔符。
`“错误”`	返回一个错误,取消导入操作。

`LeadingDelimitersRule`- - - - - -过程管理领先的分隔符
`“保持”`|`“忽略”`|`“错误”`

过程管理主要分隔符分隔的文本文件,指定为这个表中的值之一。

价值	行为
`“保持”`	分隔符。
`“忽略”`	忽略了分隔符。
`“错误”`	返回一个错误,取消导入操作。

`TrailingDelimitersRule`- - - - - -过程管理落后于分隔符
`“保持”`|`“忽略”`|`“错误”`

过程管理落后于分隔符分隔的文本文件,指定为这个表中的值之一。

领先的分隔符规则	行为
`“保持”`	分隔符。
`“忽略”`	忽略了分隔符。
`“错误”`	返回一个错误,中止导入操作。

`编码`- - - - - -字符编码方案
`”`|`“utf - 8”`|`“系统”`|`“iso - 8859 - 1”`|`“windows - 1251”`|`“windows - 1252”`|……

字符编码方案相关文件,指定为逗号分隔组成的“编码”和“系统”或一个标准字符编码方案的名字。

当你不指定任何编码,该函数使用自动字符集检测来确定当读取文件的编码。

例子:“编码”、“系统”使用系统默认的编码。

数据类型:字符|字符串

替换规则

`MissingRule`- - - - - -过程管理缺失的数据
`“填满”`(默认)|`“错误”`|`“omitrow”`|`“omitvar”`

过程管理缺失的数据,指定为这个表中的值之一。

失踪的规则	行为
`“填满”`	用的内容替换丢失的数据`FillValue`财产。的`FillValue`属性中指定`VariableImportOptions`变量被导入的对象。有关访问的更多信息`FillValue`财产,看到`getvaropts`。
`“错误”`	停止进口和显示一个错误消息显示丢失的记录和字段。
`“omitrow”`	省略含有缺失数据的行。
`“omitvar”`	省略变量包含缺失的数据。

例子:选择。MissingRule =“omitrow”;

数据类型:字符|字符串

`EmptyLineRule`- - - - - -程序处理空行
`“跳过”`|`“读”`|`“错误”`

程序处理的空行数据,指定为“跳过”,“读”,或“错误”。导入函数解释空白是空的。

空行规则	行为
`“跳过”`	跳过空行。
`“读”`	导入空行。导入函数解析空行中指定的值`VariableWidths`,`VariableOptions`,`MissingRule`和其他相关属性,如`空格`。
`“错误”`	显示一个错误消息并中止导入操作。

例子:选择。EmptyLineRule =“跳过”;

数据类型:字符|字符串

`ImportErrorRule`- - - - - -程序处理导入错误
`“填满”`(默认)|`“错误”`|`“omitrow”`|`“omitvar”`

指定的程序来处理导入错误,这个表中的值。

导入错误的规则	行为
`“填满”`	发生错误的数据替换的内容`FillValue`财产。的`FillValue`属性中指定`VariableImportOptions`变量被导入的对象。有关访问的更多信息`FillValue`财产,看到`getvaropts`。
`“错误”`	停止进口和显示一个错误消息显示error-causing记录和字段。
`“omitrow”`	省略行发生错误的地方。
`“omitvar”`	省略变量发生错误的地方。

例子:选择。ImportErrorRule =“omitvar”;

数据类型:字符|字符串

`ExtraColumnsRule`- - - - - -过程来处理额外的列
`“addvars”`|`“忽略”`|`“包装”`|`“错误”`

过程来处理额外的列数据,指定为这个表中的值之一。

额外的列规则	行为
`“addvars”`	进口额外的列,创建新的变量。如果有`N`额外的列,然后导入新的变量`“ExtraVar1”、“ExtraVar2’,……、“ExtraVarN”`。如果他们额外的列的数据被导入`VariableTypes`是`字符`。
`“忽略”`	忽略额外的列的数据。
`“包装”`	包装的额外列数据新记录。此操作不会改变变量的数量。
`“错误”`	显示一个错误消息并中止导入操作。

数据类型:字符|字符串

对象的功能

`getvaropts`	得到变量导入选项
`setvaropts`	设置变量导入选项
`setvartype`	设置变量的数据类型
`预览`	从文件使用导入选项预览八行

例子

全部折叠

为分隔的文本文件中的变量定义导入选项

打开生活的脚本

定义一个对象读取多个变量导入选项patients.dat。

根据你的文件的内容,定义这些变量属性:名称、类型、分隔符字符,数据起始位置,额外的列规则。

varNames = {“姓”,“性别”,“年龄”,“位置”,“高度”,“重量”,“抽烟”};varTypes = {“字符”,“分类”,“int32”,“字符”,“双”,“双”,“逻辑”};分隔符=”、“;dataStartLine = 2;extraColRule =“忽略”;

使用delimitedTextImportOptions函数和变量信息来初始化对象导入选项选择。

选择= delimitedTextImportOptions (“VariableNames”varNames,…“VariableTypes”varTypes,…“分隔符”分隔符,…“DataLines”dataStartLine,…“ExtraColumnsRule”,extraColRule);

使用预览函数对象预览数据导入选项。

预览(“patients.dat”选择)

ans =8×7表LastName性别年龄位置身高体重看上去吸烟者_______ ______ ___ _____________________________长得一样{“史密斯”}男性38{县综合医院的}71 176假{“约翰逊”}男43 {VA医院的}69 163假{威廉姆斯的}女38{圣。玛丽的医学中心131}64假{“琼斯”}{VA医院的}67女133假{“棕色”}女49{县综合医院的}64 119假{戴维斯的}女46{圣。玛丽的医学中心}68 142假{米勒的}女33 {VA医院的}64 142假{“威尔逊”}男性40 {VA医院的}68 180错误

导入数据使用readtable。

T = readtable (“patients.dat”、选择);谁T

类属性名称大小字节T 100 x7 30563表

提示

介绍:
- R2016b -DelimitedTextImportOptions对象
- R2018b -delimitedTextImportOptions函数

delimitedTextImportOptions

描述

创建

语法

描述

输入参数

numVars- - - - - -数量的变量积极的标量整数

属性

变量的属性

VariableNames- - - - - -变量名单元阵列的特征向量|字符串数组

VariableNamingRule- - - - - -国旗保存变量名“修改”(默认)|“保存”

VariableTypes- - - - - -数据类型的变量单元阵列的特征向量|字符串数组

SelectedVariableNames- - - - - -变量的子集导入特征向量|字符串标量|单元阵列的特征向量|字符串数组|数组的数值指标

VariableOptions- - - - - -类型特定的变量导入选项对象数组的变量导入选项

位置属性

DataLines- - - - - -数据位置积极的标量整数|积极的标量的整型数组

RowNamesColumn- - - - - -行名称位置0(默认)|积极的标量整数

VariableNamesLine- - - - - -变量名的位置0(默认)|积极的标量整数

VariableDescriptionsLine- - - - - -变量描述位置0(默认)|积极的标量整数

VariableUnitsLine- - - - - -变量单位位置0(默认)|积极的标量整数

分隔的文本属性

分隔符- - - - - -字段分隔符字符字符串数组|特征向量|单元阵列的特征向量

空格- - - - - -空格字符来治疗特征向量|字符串标量

LineEnding- - - - - -行尾字符[" \ n "、" \ r”,“\ r \ n”)(默认)|字符串数组|特征向量|单元阵列的特征向量

CommentStyle- - - - - -风格的评论字符串数组|特征向量|单元阵列的特征向量

ConsecutiveDelimitersRule- - - - - -过程管理连续分隔符“分裂”|“加入”|“错误”

LeadingDelimitersRule- - - - - -过程管理领先的分隔符“保持”|“忽略”|“错误”

TrailingDelimitersRule- - - - - -过程管理落后于分隔符“保持”|“忽略”|“错误”

编码- - - - - -字符编码方案”|“utf - 8”|“系统”|“iso - 8859 - 1”|“windows - 1251”|“windows - 1252”|……

替换规则

MissingRule- - - - - -过程管理缺失的数据“填满”(默认)|“错误”|“omitrow”|“omitvar”

EmptyLineRule- - - - - -程序处理空行“跳过”|“读”|“错误”

ImportErrorRule- - - - - -程序处理导入错误“填满”(默认)|“错误”|“omitrow”|“omitvar”

ExtraColumnsRule- - - - - -过程来处理额外的列“addvars”|“忽略”|“包装”|“错误”

对象的功能

例子

为分隔的文本文件中的变量定义导入选项

提示

另请参阅

功能

住编辑任务

`numVars`- - - - - -数量的变量
积极的标量整数

`VariableNames`- - - - - -变量名
单元阵列的特征向量|字符串数组

`VariableNamingRule`- - - - - -国旗保存变量名
`“修改”`(默认)|`“保存”`

`VariableTypes`- - - - - -数据类型的变量
单元阵列的特征向量|字符串数组

`SelectedVariableNames`- - - - - -变量的子集导入
特征向量|字符串标量|单元阵列的特征向量|字符串数组|数组的数值指标

`VariableOptions`- - - - - -类型特定的变量导入选项
对象数组的变量导入选项

`DataLines`- - - - - -数据位置
积极的标量整数|积极的标量的整型数组

`RowNamesColumn`- - - - - -行名称位置
`0`(默认)|积极的标量整数

`VariableNamesLine`- - - - - -变量名的位置
`0`(默认)|积极的标量整数

`VariableDescriptionsLine`- - - - - -变量描述位置
`0`(默认)|积极的标量整数

`VariableUnitsLine`- - - - - -变量单位位置
`0`(默认)|积极的标量整数

`分隔符`- - - - - -字段分隔符字符
字符串数组|特征向量|单元阵列的特征向量

`空格`- - - - - -空格字符来治疗
特征向量|字符串标量

`LineEnding`- - - - - -行尾字符
`[" \ n "、" \ r”,“\ r \ n”)`(默认)|字符串数组|特征向量|单元阵列的特征向量

`CommentStyle`- - - - - -风格的评论
字符串数组|特征向量|单元阵列的特征向量

`ConsecutiveDelimitersRule`- - - - - -过程管理连续分隔符
`“分裂”`|`“加入”`|`“错误”`

`LeadingDelimitersRule`- - - - - -过程管理领先的分隔符
`“保持”`|`“忽略”`|`“错误”`

`TrailingDelimitersRule`- - - - - -过程管理落后于分隔符
`“保持”`|`“忽略”`|`“错误”`

`编码`- - - - - -字符编码方案
`”`|`“utf - 8”`|`“系统”`|`“iso - 8859 - 1”`|`“windows - 1251”`|`“windows - 1252”`|……

`MissingRule`- - - - - -过程管理缺失的数据
`“填满”`(默认)|`“错误”`|`“omitrow”`|`“omitvar”`

`EmptyLineRule`- - - - - -程序处理空行
`“跳过”`|`“读”`|`“错误”`

`ImportErrorRule`- - - - - -程序处理导入错误
`“填满”`(默认)|`“错误”`|`“omitrow”`|`“omitvar”`

`ExtraColumnsRule`- - - - - -过程来处理额外的列
`“addvars”`|`“忽略”`|`“包装”`|`“错误”`