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来“保存”．

例子:选择。VariableNames返回当前(检测到的)变量名。

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

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

`VariableNamingRule`- - - - - -标志以保留变量名
`“修改”`(默认)|`“保存”`

标志以保留变量名，指定为逗号分隔对，由VariableNamingRule,要么“修改”或“保存”．

“修改”-转换无效的变量名(由isvarname函数)的有效MATLAB标识符。
“保存”-保留不是有效的MATLAB标识符的变量名，例如包含空格和非ascii字符的变量名。

从R2019b开始，变量名和行名可以包含任何字符，包括空格和非ascii字符。此外，它们可以以任何字符开头，而不仅仅是字母。变量和行名不一定是有效的MATLAB标识符(由isvarname功能)。要保留这些变量名和行名，可以设置VariableNamingRule来“保存”．

数据类型:字符|字符串

`VariableTypes`- - - - - -变量的数据类型
字符向量的单元格数组|字符串数组

变量的数据类型，指定为字符向量的单元格数组或包含一组有效数据类型名称的字符串数组。的VariableTypes属性指定在导入变量时要使用的数据类型。

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

例子:选择。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函数。

例子:选择。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，则不导入变量名。否则，从指定行导入变量名。

例子:选择。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,{“/ *”}

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

`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`．
`“错误”`	停止导入并显示一个错误消息，显示导致错误的记录和字段。
`“omitrow”`	省略出现错误的行。
`“omitvar”`	省略发生错误的变量。

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

数据类型:字符|字符串

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

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

额外的列规则	行为
`“addvars”`	要导入额外的列，请创建新变量。如果有`N`额外的列，然后导入新的变量`“ExtraVar1”、“ExtraVar2’,……、“ExtraVarN”`．注意:额外的列作为带有数据类型的文本导入`字符`．
`“忽略”`	忽略额外的数据列。
`“包装”`	将额外的数据列包装到新记录中。这个操作不会改变变量的数量。
`“错误”`	显示错误消息并中止导入操作。

数据类型:字符|字符串

对象的功能

`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{圣。{' Mary's Medical Center'} 64 131 false {'Jones'}} 40 {'VA Hospital'} 67 133 false {'Brown'}} 49 {'County General Hospital'} 64 119 false {'Davis'}} 46 {'St。Mary's Medical Center'} 68 142 false {'Miller'}女33 {'VA医院'}64 142 false {'Wilson'}男40 {'VA医院'}68 180 false

使用以下命令导入数据readtable．

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

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

提示

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

另请参阅

detectImportOptions|readtable

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”|“忽略”|“包装”|“错误”

对象的功能

例子

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

提示

另请参阅

MATLAB的文档

金宝app

介绍基于MATLAB的深度学习

`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”`|`“忽略”`|`“包装”`|`“错误”`