文档

DelimitedTextImportOptions

进口为分隔文本选择对象

描述

一个DelimitedTextImportOptions对象允许您指定如何MATLAB®从文本文件导入表格数据。对象包含属性控制数据导入过程,包括错误和缺失数据的处理。使用一个DelimitedTextImportOptions对象查询当前(发现)导入属性的值或分配新值根据您的进口需求。

创建对象

创建一个DelimitedTextImportOptions对象使用detectImportOptions函数。

属性

全部展开

变量的属性

变量名称,指定为一个单元阵列的特征向量。的VariableNames属性包含要使用的名称在导入变量。

如果数据包含N变量,但没有检测到的变量名,然后VariableNames属性包含{‘Var1’,‘Var2’,……,“VarN”}

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

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

数据类型:字符|细胞

变量的数据类型,指定为一个单元阵列的特征向量。的VariableTypes属性指定的数据类型使用在导入变量。当分配新值,指定VariableTypes作为一个单元阵列的有效数据类型名称。

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

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

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

数据类型:细胞|||int8|int16|int32|int64|uint8|uint16|uint32|uint64|逻辑|字符|分类|datetime

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

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

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

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

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

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

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

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

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

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

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

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

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

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

位置属性

数据开始位置,指定为一个积极的标量整数。的DataLine属性指定的行号数据开始在文本文件中。

的值DataLine属性必须大于0

例子:选择。DataLine = 5;

数据类型:||uint8|uint16|uint32|uint64

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

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

例子:选择。RowNamesColumn = 2;

数据类型:||uint8|uint16|uint32|uint64

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

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

例子:opts.VariableNamesLine = 6;

数据类型:||uint8|uint16|uint32|uint64

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

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

例子:选择。VariableDescriptionsLine = 7;

数据类型:||uint8|uint16|uint32|uint64

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

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

例子:选择。VariableUnitsLine = 8;

数据类型:||uint8|uint16|uint32|uint64

分隔的文本属性

字段分隔符字符,指定为一个字符特征向量的向量或一个单元阵列。

例子:“|”

例子:{‘;’,‘*’}

数据类型:字符|细胞

字符视为空白,指定为一个或多个字符的特征向量。

例子:“_”

例子:“? !,”

行尾字符,指定一个或多个字符的特征向量或一个单元阵列的特征向量。

例子:' \ n '

例子:“\ r \ n”

例子:{‘\ b’,‘:’}

数据类型:字符|细胞

风格的评论,指定为一个字符特征向量的向量或单元阵列。

例如,指定CommentStyle作为“%”忽视文本后百分之一的符号在同一行。

例子:{“/ *”}

数据类型:字符|细胞

指定的程序来处理连续分隔符,此表中的值。

连续分隔符规则 行为
“分裂” 将连续分隔符分割为多个字段。
“加入” 加入分隔符为一个分隔符。
“错误” 错误和中止导入操作。

例子:“加入”

过程管理领先的分隔符,指定为这个表中的值之一。

领先的分隔符规则 行为
“保持” 分隔符。
“忽略” 忽略了分隔符。
“错误” 错误和中止导入操作。

例子:“忽略”

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

“繁体”

“iso - 8859 - 1”

“windows - 847”

“Big5-HKSCS”

“iso - 8859 - 2”

“windows - 949”

“CP949”

“iso - 8859 - 3”

“windows - 1250”

“EUC-KR”

“iso - 8859 - 4”

“windows - 1251”

“EUC-JP”

“iso - 8859 - 5”

“windows - 1252”

“EUC-TW”

“iso - 8859 - 6”

“windows - 1253”

“GB18030”

“iso - 8859 - 7”

“windows - 1254”

“GB2312”

“iso - 8859 - 8”

“windows - 1255”

“GBK”

“iso - 8859 - 9”

“windows - 1256”

“IBM866”

“iso - 8859 - 11”

“windows - 1257”

“KOI8-R”

“iso - 8859 - 13”

“windows - 1258”

“KOI8-U”

“iso - 8859 - 15”

“us - ascii”

“麦金塔”

“utf - 8”

“Shift_JIS”

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

替换规则

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

失踪的规则 行为
“填满”

用的内容替换丢失的数据FillValue财产。

FillValue属性中指定VariableImportOptions变量被导入的对象。有关访问的更多信息FillValue财产,看到getvaropts

“错误” 停止进口和显示一个错误消息显示丢失的记录和字段。
“omitrow” 省略含有缺失数据的行。
“omitvar” 省略变量包含缺失的数据。

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

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

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

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

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

导入错误的规则 行为
“填满”

发生错误的数据替换的内容FillValue财产。

FillValue属性中指定VariableImportOptions变量被导入的对象。有关访问的更多信息FillValue财产,看到getvaropts

“错误” 停止进口和显示一个错误消息显示error-causing记录和字段。
“omitrow” 省略行发生错误的地方。
“omitvar” 省略变量发生错误的地方。

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

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

额外的列规则 行为
“addvars”

进口额外的列,创建新的变量。如果有N额外的列,然后导入新的变量“ExtraVar1”、“ExtraVar2’,……、“ExtraVarN”

注意:额外的列是进口作为文本和数据类型字符

“忽略” 忽略额外的列的数据。
“包装” 包装的额外列数据新记录。此操作不会改变变量的数量。
“错误” 显示一个错误消息并中止导入操作。

例子:

对象的功能

getvaropts 得到变量导入选项
setvaropts 设置变量导入选项
setvartype 设置变量的数据类型

例子

全部展开

创建导入选项,裁缝多个变量的数据类型,然后读取数据。

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

选择= detectImportOptions (“airlinesmall.csv”)
选择= DelimitedTextImportOptions属性:格式属性:分隔符:{" "}空白:“\ b \ t”LineEnding: {' \ n ' ' \ r \ r \ n”} CommentStyle: {} ConsecutiveDelimitersRule:“分裂”LeadingDelimitersRule:“保持”EmptyLineRule:“跳过”编码:“us - ascii”替代属性:MissingRule:“填补”ImportErrorRule:“填补”ExtraColumnsRule:“addvars”变量导入属性:设置类型的名字使用setvartype VariableNames:{“年”、“月”,“DayofMonth”……和26}VariableTypes:{“双”、“双”、“双”……和26}SelectedVariableNames:{“年”、“月”、“DayofMonth”……和26}VariableOptions:显示所有29 VariableOptions访问VariableOptions sub-properties使用setvaropts / getvaropts位置属性:DataLine: 2 VariableNamesLine: 1 RowNamesColumn: 0 VariableUnitsLine: 0 VariableDescriptionsLine: 0

检查类型属性的变量TaxiInTaxiOut

getvaropts(选择,{“TaxiIn”,“TaxiOut”})
ans = 1×2 TextVariableImportOptions数组属性:WhitespaceRule类型FillValue名称QuoteRule TreatAsMissing

改变变量的类型TaxiInTaxiOut

选择= setvartype(选择,{“TaxiIn”,“TaxiOut”},“双”);

指定导入并检查变量的子集。

选择。SelectedVariableNames = {“TaxiIn”,“TaxiOut”};

使用readtable函数以及选择对象导入选定的变量。显示表的一个总结。

T = readtable (“airlinesmall.csv”、选择);总结(T)
变量:TaxiIn: 123523×1双值:最小0值5最大1451 NumMissing 37383 TaxiOut: 123523×1双值:755 NumMissing 37364最小13 0值最大

介绍了R2016b

这个主题有帮助吗?