setvaropts

设置变量导入选项

折叠所有页面

语法

opts = setVaropts（opts，name，值）

opts=setvaropts（选项、选择、名称、值）

描述

选择= setvaropts (选择，名称,值）中的所有变量选择对象的规格名称,值参数并返回选择对象。

例子

选择= setvaropts (选择，选择，名称,值）更新和返回选择中指定的变量选择参数，基于名称,值论点。

例子

全部折叠

设置选定变量的选项

打开直播脚本

创建导入选项对象，为选定的变量设置选项，并使用定制的选项和readtable函数。

为电子表格创建一个选项对象patients.xls．

选择= detectImportOptions (“patients.xls”)；

设定FillValue本物业吸烟者，舒张，和收缩的变量。

opts=setvaropts（opts，“吸烟者”，“FillValue”，错误的）;选择= setvaropts(选择,{舒张压的，'收缩'}，“FillValue”, 0);

选择要导入的变量。

opts.selectedvariablenames = {“吸烟者”，舒张压的，'收缩'};

导入变量并显示摘要。

T = readtable (“patients.xls”、选择);总结(T)

变量：吸烟者：100x1逻辑值：TRUE 34 FALSE 66舒张：100x1双重值：MIN 68中位数81.5 MAX 99收缩量：100x1双值：MIN 109中位数122 MAX 138

设置“包含缺失或不完整记录的数字数据”选项

打开直播脚本

导入字段缺失或不完整的数据需要识别缺失的实例，并决定如何导入缺失的实例。使用importOptions捕获这两个决策并使用readtable．

为文件创建导入选项对象，更新控制导入丢失数据的属性，然后使用readtable来导入数据。请注意，数据集Airlinesmall.csv.有两个数字变量ArrDelay和戴德雷，其中包含由指示的缺失数据NA．

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

选择= detectImportOptions (“airlinesmall.csv”)；

使用治疗减少属性指定数据中的数据中的字符持有丢失实例。在此示例中，两个数字变量ArrDelay和戴德雷包含包含文本的缺失字段NA．

选择= setvaropts(选择,{“ArrDelay”，“DepDelay”}，“TreatAsMissing”，'na')；

导入丢失实例时要指定导入函数的操作。看ImportOptions属性页面有关更多选项。

opts.missingrule =“填充”；

指定导入函数发现缺失实例时要使用的值。这里是变量中缺少的实例ArrDelay和戴德雷取而代之的是0．

选择= setvaropts(选择,{“ArrDelay”，“DepDelay”}，“FillValue”, 0);

选择要使用的变量并导入它们readtable．

opts.selectedvariablenames = {“ArrDelay”，“DepDelay”}；T=可读性(“airlinesmall.csv”、选择);

检查中的值ArrDelay和戴德雷．验证导入函数是否替换为表示的缺失值NA．

T (166:180:)

ans=15×2表ArrDelay DepDelay ________ ________ -1 0 102 105 -11 0 0 0 10 0 0 10 0 10 10 0 14 0 -14 05 0 25 38 0 -5 0 0 6 0

设置十六进制和二进制数的选项

打开直播脚本

的readtable功能自动检测十六进制和二进制数0x.和0B.前缀。若要在这些数字没有前缀时导入它们，请使用导入选项对象。

为文件创建导入选项对象hexAndBinary.txt．它的第三列是十六进制数，没有0x.前缀

选择= detectImportOptions (“hexAndBinary.txt”）

opts=DelimitedTextImportOptions和属性：格式属性：分隔符：{'，}空白：'\b\t'行尾：{'\n'\r'\r\n'}注释样式：{}ConcertiveDelimiterRule:'split'LeadingDelimiterRule:'keep'TrailingDelimiterRule:'ignore'EmptyLineRule:'skip'编码：'UTF-8'替换属性：MissingRule:'fill'ImportErrorRule:'fill'ExtraColumnsRule:'addvars'变量导入属性：使用setvartype VariableNames按名称设置类型：{'Var1'、'Var2'、'Var3'…和1个以上}变量类型：{'auto'、'auto'、'char'…和1个以上}选择的变量名称：{'Var1'、'Var2'、'Var3'…和1个以上}变量选项：显示所有4个变量选项使用setvaropts/getvaropts VariableNamingRule访问变量选项子属性：“修改”位置属性：数据行：[1 Inf]VariableNamesLine:0 RowNamesColumn:0 VariableUnitsLine:0 VariableDescriptionLine:0若要显示表的预览，请使用preview

要指定第三列应该作为十六进制值导入，尽管没有前缀，请使用setvaropts函数。将第三变量的变量类型设置为int32．将导入第三列的数字系统设置为十六进制．

选择= setVaropts（选择，3，“NumberSystem”，'六角'，'类型'，“int32”）

opts = DelimitedTextImportOptions with properties: Format properties: Delimiter:{'，'}空白:'\b\t ' LineEnding: {'\n' '\r' '\r\n'} CommentStyle: {} ConsecutiveDelimitersRule: 'split' LeadingDelimitersRule: 'keep' TrailingDelimitersRule: 'ignore' EmptyLineRule: 'skip' Encoding: 'UTF-8'替换属性:missinggrule:'fill' ImportErrorRule: 'fill' ExtraColumnsRule: 'addvars'变量导入属性:使用setvartype VariableNames: {'Var1'， 'Var2'， 'Var3'…{'auto'， 'auto'， 'int32'…{'Var1'， 'Var2'， 'Var3'…和1}VariableOptions:显示所有4 VariableOptions访问VariableOptions sub-properties使用setvaropts / getvaropts VariableNamingRule:“修改”位置属性:DataLines:[1正]VariableNamesLine: 0 RowNamesColumn: 0 VariableUnitsLine: 0 VariableDescriptionsLine: 0显示表的预览,预览使用

读取文件并将前三列导入数字值。的readtable函数自动检测第一列和第二列是否包含十六进制和二进制值。导入选项对象指定第三列也包含十六进制值。

T = readtable (“hexAndBinary.txt”，选择）

T=3×4表Var1 Var2 Var3 Var4 _________ _____ ___________ 255 255 51193 {'Device1'} 256 4 1471 {'Device2'} 43981 129 61455 {'Device3'}

导入文本数据时设置选项

打开直播脚本

使用setvaropts函数更新控制文本数据导入的属性。首先，获取文件的导入选项对象。接下来，检查和更新文本变量的选项。最后，使用readtable函数。

预览中的数据patients.xls．注意列中的文本数据姓．这里只显示了前10行的预览。

获取导入选项对象。

选择= detectImportOptions (“patients.xls”)；

获取并检查VariableImportOptions为变量姓．

getvaropts(选择,“姓”）

ans=TextVariableImportOptions with properties:变量属性：Name:'LastName'类型：'char'FillValue:'TreatAsMissing:{}QuoteRule:'remove'前缀：{}后缀：{}EmptyFieldDrule:'missing'字符串选项：WhitespaceRule:'trim'

将变量的数据类型设置为一串．

opts = setvartype（opts，“姓”，“字符串”)；

设定FillValue属性来替换缺失值“无名”．

opts=setvaropts（opts，“姓”，“FillValue”，“无名”)；

选择，读取和显示变量的前10行的预览。

选择。年代electedVariableNames =“姓”；T = readtable (“patients.xls”、选择);T.LastName (1:10)

ans =10x1串“史密斯”、“约翰逊”、“威廉姆斯”、“琼斯”、“布朗”、“戴维斯”、“米勒”、“威尔逊”、“摩尔”、“泰勒”

导入逻辑数据时设置选项

打开直播脚本

使用setvaropts函数来更新控制导入的属性逻辑数据。首先，获取文件的导入选项对象。接下来，检查并更新逻辑变量的选项。最后，使用readtable函数。

预览中的数据airlinesmall_subset.xlsx.请注意列中的逻辑数据取消．这里仅示出了行30至40的预览。

获取导入选项对象。

选择= detectImportOptions ('airlinesmall_subset.xlsx')；

获取并检查VariableImportOptions为变量取消．

getvaropts(选择,'取消'）

ans = NumericVariableImportOptions with properties: Variable properties: Name: 'Cancelled' Type: 'double' FillValue: NaN TreatAsMissing: {} QuoteRule: 'remove' Prefixes: {} suffix: {} emptyfieldrole: 'missing' Numeric Options: ExponentCharacter: 'eEdD' DecimalSeparator: '.'千分号:" TrimNonNumeric: 0 NumberSystem: 'decimal'

将变量的数据类型设置为逻辑．

opts = setvartype（opts，'取消'，“逻辑”)；

设定FillValue属性来替换缺失值真的．

opts=setvaropts（opts，'取消'，“FillValue”，对）；

选择，读取和显示变量的摘要。

选择。年代electedVariableNames ='取消'；T = readtable ('airlinesmall_subset.xlsx'、选择);总结(T)

变量：取消：1338x1逻辑值：TRUE 29 FALSE 1309

导入日期和时间数据

打开直播脚本

使用DateTimevarifeimportOptions.属性以控制其导入datetime数据。第一步,把ImportOptions对象。接下来，检查和更新VariableImportOptions对于DateTime变量。最后，使用的是导入变量readtable．

内的数据预览中断.csv．请注意列中的日期和时间数据OutageTime和RestorationTime．这里只显示了前10行。

获取导入选项对象。

选择= detectImportOptions (“中断.csv”)；

获取并检查VariableImportOptionsdatetime变量OutageTime和RestorationTime．

varopts = getVaropts（opts，{'OutageTime'，“RestorationTime”}）

varOpts = 1x2 DatetimeVariableImportOptions数组，带有属性:Name Type FillValue TreatAsMissing QuoteRule Prefixes suffix EmptyFieldRule DatetimeFormat DatetimeLocale TimeZone InputFormat

设定FillValue变量的属性以使用当前日期和时间替换丢失的值。

选择= setvaropts(选择,{'OutageTime'，“RestorationTime”}，...“FillValue”，'现在')；

选择、读取和预览这两个变量。注意在第二行中缺少的值RestorationTime已填入当前日期和时间。

opts.selectedvariablenames = {'OutageTime'，“RestorationTime”}；T=可读性(“中断.csv”、选择);T（1:10，:)

ans=10×2表OutageTime RestorationTime ________________ ________________ 2002-02-01 12:18 2002-02-07 16:50 2003-01-23 00:49 2012-02-23 15:06 2003-02-07 21:15 2003-02-17 08:14 2004-04-06 05:44 2004-04-06 06:10 2002-03-16 06:18 2002-03-18 23:23 2003-06-18 02:49 2003-06-18 10:54 2004-06-20 14:39 2004-06-20 19:16 2002-06-06 19:28 2002-06-07 00:51 2003-07-16 16:232004-09-17 01:12 2004-09-27 11:09 2004-09-27 16:37

导入分类数据时设置选项

打开直播脚本

使用setvaropts函数来更新控制导入的属性分类数据。首先，获取文件的导入选项对象。接下来，检查并更新分类变量的选项。最后，使用readtable函数。

预览中的数据中断.csv.请注意列中的分类数据区域和原因．该表只显示了前10行。

获取导入选项对象。

选择= detectImportOptions (“中断.csv”)；

获取并检查变量的选项区域和原因．

getvaropts(选择,{“区域”，“原因”}）

ans=1x2 TextVariableImportOptions数组，具有以下属性：名称类型FillValue处理缺少引号前缀后缀EmptyFieldRule空白

将变量的数据类型设置为分类．

opts=setvartype（opts{“区域”，“原因”}，“绝对的”)；

设定FillValue变量的属性以用类别名称替换缺失的值“杂项”．集治疗减少财产'未知'．

选择= setvaropts(选择,{“区域”，“原因”}，...“FillValue”，“杂项”，...“TreatAsMissing”，'未知')；

选择，读取和显示两个变量的摘要。

opts.selectedvariablenames = {“区域”，“原因”}；T=可读性(“中断.csv”、选择);总结(T)

变量:地区:1468x1类别值:MidWest 142 NorthEast 557 SouthEast 389 SouthWest 26 West 354原因:1468x1类别值:杂项24 attack 294 earthquake 2 energy emergency 188 equipment fault 156 fire 25 severe storm 338 thunder storm 201 wind 95 winter storm 145

从变量中删除前缀或后缀字符

打开直播脚本

导入包含不需要的前缀和后缀字符的变量的表格数据。首先，创建导入选项对象并预览数据。然后，选择感兴趣的变量并设置它们的变量类型和属性以删除不需要的字符。最后，导入感兴趣的数据。

为文件创建导入选项，并预览表。

文件名=“pref_suff_trim.csv”；opts=detectImportOptions（文件名）；预览（文件名，opts）

ans=8×5表时间DayOfWeek电力Total_Fees温度  _______________________ _______________ ____________ __________ ___________ ' 时间戳:1/1/06 0:00 ' ',太阳% 20 ' ' 54.5448 MW‘$ 1.23“-7.2222 C“时间戳:1/2/06一点' ',星期四% 20 ' ' .3898MW ' ' 300.00 ' ' -7.3056美元C“时间戳:1/3/06两点' ',太阳% 20 ' ' 51.6344 MW“C£2.50 ' ' -7.8528 ' '时间戳:1/4/06三点' ',太阳% 20 ' ' 51.5597 MW‘$ 0.00“-8.1778 C“时间戳:1/5/06 4 ' ',结婚% 20 ' ' 51.7148 MW“C¥4.00 ' ' -8.9343 ' '时间戳:1/6/06五点' ',太阳% 20 ' ' 52.6898 MW‘$ 0.00“-8.7556 C“时间戳:1/7/06 6 ' ',Mon % 20 ' ' 55.341 MW‘$ 50.70“-8.0417 C“时间戳:1/8/06 7点' ',Sat %20' ' ' 7.1512 MW' '$0.00' '-8.2028 C'

选择感兴趣的变量，指定其类型，并检查其变量导入选项值。

opts.selectedvariablenames = {“时间”，“Total_Fees”，“温度”}; opts=setvartype（opts，“时间”，'约会时间'); opts=setvaropts（opts，“时间”，“InputFormat”，'MM/dd/uu HH:MM')；％指定DATETIME格式opts=setvartype（opts{“Total_Fees”，“温度”}，“双”)；getvaropts（opts{“时间”，“Total_Fees”，“温度”}）

ans = 1 x3 VariableImportOptions数组属性:变量选择:(1)|(2)|(3)名称:“时间”|“Total_Fees”|“温度”类型:“datetime”|“双重”|“双重”FillValue: (NaT) |(南)|(南)TreatAsMissing : {} | {} | {} QuoteRule:“删除”|“删除”|“删除”前缀 : {} | {} | {} 后缀:要访问每个变量的子属性，请使用getvaropts

设定前缀，后缀，和trimnonnumeric.要删除的变量导入选项的属性的时间戳:来自变量时间、删除后缀“C”从变量温度，并从变量中删除所有非数字字符总费用．使用新的导入选项预览表。

opts=setvaropts（opts，“时间”，“前缀”，的时间戳:); opts=setvaropts（opts，“温度”，“后缀”，“C”); opts=setvaropts（opts，“Total_Fees”，“TrimNonNumeric”，对）；预览(文件名,选择)

ans=8×3表时间Total_Fees温度______________ __________ ___________ 01/01/06 00:00 1.23 -7.2222 01/02/06 01:00 300 -7.3056 01/03/06 02:00 2.5 -7.8528 01/04/06 03:00 0 -8.1778 01/05/06 04:00 4 -8.9343 01/06/06 05:00 0 -8.7556 01/07/06 06:00 50.7 -8.0417 01/08/06 07:00 0 -8.2028

使用导入数据readtable．

T = readtable(文件名,选择);

管理空字段的导入

打开直播脚本

为包含空字段的文件创建导入选项对象。使用EmptyFieldRule参数管理数据中的空字段的导入。首先，预览数据，然后设置EmptyFieldRule特定变量的参数。最后，套装EmptyFieldRule对于所有变量并导入数据。

为包含空字段的文件创建导入选项对象。使用预览函数。默认值EmptyFieldRule是“失踪”．因此，导入函数将空字段视为缺失，并用FillValue该变量的值。使用可变选项对于第三个变量，预览数据。在这里,预览函数将第三个变量中的空字段导入为南s。

文件名='datawith rempeys.csv'；选择= detectImportOptions(文件名);opts.VariableOptions (3)％显示第3变量的变量选项

ans = numericvarifeimportoptions，属性：变量属性：名称：'double'类型：'double'fillvalue：naN injinismissing：{} quoteRule：'删除'前缀：{}后缀：{} extentFieldRule：{} extentFieldRule：'缺少'数字选项：exponentcharacter：'eedd'decimalseparator：'。'千分号:" TrimNonNumeric: 0 NumberSystem: 'decimal'

预览(文件名,选择)

ans=8×7表词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇词汇{'b'}201/21/0018{'FALSE'}09:00:01{'def'}{'ghi'}{0x0 char}301/31/0018{'TRUE'}02:00:01{'ghi'}{'jkl'}{'a'}{'a'}NaN 2018年2月23日{'FALSE'}03:00:01{'jkl'}{'mno'}{'a'}{'4 NaT{'FALSE'}04:00:01{'mno'}{'pqr'}{'b'}{'5 01/23/0018{'0x0 char}05:00:01{'pqr'}{'stu'}{'b'}5 03/23/0018{'FALSE'}NaN{'stu'}{'0x0 char 6 03/24/2018{'0x0 char 0}{'07:00}{'

集EmptyFieldRule对于表中的第二个变量。首先，选择变量，然后设置EmptyFieldRule到“汽车”．在这里,readtable函数导入空字段分类变量,<定义>．

选择。年代electedVariableNames =“分类”；opts=setvartype（opts，“分类”，“绝对的”); opts=setvaropts（opts，“分类”，“空场”，“汽车”)；T=可读性（文件名，选项）

T=10×1表分类___________ a b <未定义> a b b a <未定义>

接下来,设置EmptyFieldRule表中所有变量的参数。首先，适当地更新变量的数据类型。对于此示例，将第五个和第七变量的数据类型设置为逻辑和一串，分别。然后，集EmptyFieldRule对于所有变量“汽车”．导入函数根据变量的数据类型导入空字段。在这里,readtable函数导入空字段逻辑变量,0和空旷的田野分类变量,<定义>．

VariableNames = opts.VariableNames;选择。年代electedVariableNames = VariableNames;％选择所有变量opts=setvartype（opts{“逻辑”，'细绳'},{“逻辑”，“字符串”}）;opts = setvaropts（opts，variablenames，“空场”，“汽车”)；T=可读性（文件名，选项）

T=10×7表文本分类双Datetime逻辑时间字符串  __________ ___________ ______ __________ _______ ________ _________ {' abc '} 1 01/14/0018真00:00:01“abc”{0 x0 char} b 2 01/21/0018假09:00:01“def”{“酥油”}<定义> 3 01/31/0018真正02:00:01“酥油”{. jkl的}南02/23/2018假03:00:01 . jkl“{”mno} 4假04:00:01 NaT"mno" {'pqr'} b 5 03/23/0018 false 05:00:01 "pqr" {'stu'} b 5 03/23/0018 false NaN "stu" {0x0 char} a 6 03/24/2018 true 07:00:01 "" {0x0 char} a 7 03/25/2018 true 08:00:01  {'xyz'}  NaN NaT true 06:00:01 "xyz"

此外“失踪”和“汽车”，也可以设置EmptyFieldRule参数到“错误”．当你把它设置为“错误”,readtable方法中指定的过程将导入空字段进口许可证参数

输入参数

全部折叠

`选择`- - - - - -文件导入选项
`SpreadSheetimportOptions.`|`DelimitedTextImportOptions`|`多个沃特莫特选项`

文件导入选项，指定为aSpreadSheetimportOptions.，DelimitedTextImportOptions，或者多个沃特莫特选项对象创建的检测端口选项函数。的选择对象包含控制数据导入进程的属性，例如变量属性，数据位置属性，替换规则和其他。

`选择`- - - - - -选择变量
特征向量|字符串标量|字符向量的单元格数组|字符串数组|一系列索引|逻辑阵列

选定的变量，指定为字符向量，字符串标量，字符向量，字符串数组，数字索引数组或逻辑阵列。

变量名称（或索引）必须是包含在内的名称的子集VariableNames财产的选择对象。

例子：“高度”

例子：{“高度”,“姓”}

例子：9 [5]

数据类型：字符|一串|细胞|uint64|逻辑

名称-值对的观点

指定可选的逗号分隔的对名称,值论点。姓名参数名和价值是相应的价值。姓名必须出现在引号内。可以以任意顺序指定多个名称和值对参数name1，value1，...，namen，valuen．

例子：选择= setvaropts(选择、“重量”、“FillValue”,0)设置FillValue为变量重量到0．

所有变量类型的常见选项

全部折叠

`'类型'`- - - - - -数据类型的变量
`“char”`|`“字符串”`|`“单身”`|`“双”`|`“int8”`|`“int16”`|...

变量的数据类型，指定为表中列出的数据类型。

数据类型	描述
`“char”` `“字符串”`	文本。
`“单身”` `“双”`	单精度或双精度浮点数。
`“int8”`，`“int16”`，`“int32”`，`“int64”` `“uint8”`，`'uint16'`，`‘uint32’`，`“uint64”`	有符号或无符号整数，存储为8、16、32或64位整数。整数数据类型没有定义与浮点数相对应的值`南`，`负`，和`+正`．因此，当您将浮点数据导入作为整数数组时，导入函数会转换未定义的浮点号： `南`转换为`0`． `负`使用?转换为指定整数数据类型的最小整数`intmin.`函数。 `+正`使用?转换为指定整数数据类型的最大整数`intmax`函数。
`“逻辑”`	True或false值(例如，`真的`，`假`，`1`，或者`0`)．
`'约会时间'`	指定时间点的日期和时间(例如，`2019-12-10 09:12:56`指定2019年12月10日上午9:12:56）。
`'期间'`	时间长度（例如，`05:13:45`指定5小时、13分钟和45秒)。
`“绝对的”`	指定类别的数字或文本数据(例如，`“红色”`，`“绿色”`，和`“蓝色”`指定三类名称）。

`“FillValue”`- - - - - -缺失数据的替换值
特征向量|字符串标量|标量数值|`真的`|`假`

丢失数据的替换值，取决于变量的类型，指定为字符向量、字符串标量、标量数字或逻辑值真的或者假．

类型的变量	描述
文本	指定为字符向量或字符串标量的替换文本。例子：`“不适用”`
数字	标量数值来替换缺失的实例导入函数将输入转换为`FillValue`到所指定的数据类型`类型`变量的属性。例如,如果`类型`属性值是`uint8`，则导入函数也转换`FillValue`财产`uint8`．例子：`0`
逻辑	`真的`或者`假`．例子：`假`
Datetime	字符向量或字符串标量，或表示日期和时间数据的标量值。有关“有效”的详细信息`datetime`输入,看到`datetime`功能页面。例子：`'现在'`将缺失的datetime实例设置为当前日期和时间。例子：`[1998年12 1]`将缺少的DateTime实例设置为1998年12月1日的日期。
持续时间	字符向量或字符串标量，或表示持续时间数据的标量值。有关“有效”的详细信息`持续时间`输入,看到`持续时间`功能页面。例子：`'12：30：16'`将缺少的持续时间实例设置为12小时、30分钟和16秒的持续时间。
明确的	包含要用于替换类别的名称的字符向量或字符串标量。例子：`“杂项”`将类别名称分配给分类数据中的类别缺少实例。

要直接导入丢失的、不可转换的或导致错误的数据，请同时使用以下四个属性:FillValue，治疗减少，丢失规则，和ErrorRule。导入函数使用FillValue属性时：

数据不可转换或与中的值匹配治疗减少．
丢失规则或者是ErrorRule被设定为填．

`“TreatAsMissing”`- - - - - -要解释为缺少数据的文本
特征向量|字符串标量|字符向量单元数组|字符串数组

将文本解释为缺失数据，并指定为字符向量、字符串标量、字符向量单元数组或字符串数组。

当导入函数发现缺少的实例时，它使用丢失规则属性来确定适当的操作。

例子：TreatAsMissing,{“NA”,“TBD”}指示导入函数处理任何出现的NA或者TBD作为一个失踪的领域。

数据类型：字符|一串|细胞

`'批批'`- - - - - -管理双引号的过程
`“删除”`|`'保持'`|`“错误”`

管理数据中的双引号的方法，指定为该表中的值之一。

引用规则过程

引用规则	过程
`“删除”`	If双引号(`＂`)包围字符，然后导入函数删除开始的双引号和出现的下一个双引号，下一个双引号将被解释为结束的双引号。例子：`“500”`作为进口`500`．如果两组双引号(`＂＂`)包围字符，然后导入函数删除前两个出现的字符。例子：`”“abc”“`作为进口`美国广播公司"`．如果围绕字符的一对打开和关闭引用，后跟单个孤独的未配对双引号，则导入功能忽略了孤独的未配对双报。例子：`“abc”“`作为进口`美国广播公司(abc)”`．
`'保持'`	保留所有引号。
`“错误”`	在转换以双引号开始的数据时报告错误（`＂`)．如果不应引用该字段，请使用此设置。

“删除”

If双引号(＂)包围字符，然后导入函数删除开始的双引号和出现的下一个双引号，下一个双引号将被解释为结束的双引号。

例子：“500”作为进口500．

如果两组双引号(＂＂)包围字符，然后导入函数删除前两个出现的字符。

例子：”“abc”“作为进口美国广播公司"．

如果围绕字符的一对打开和关闭引用，后跟单个孤独的未配对双引号，则导入功能忽略了孤独的未配对双报。

例子：“abc”“作为进口美国广播公司(abc)”．

'保持'

保留所有引号。

“错误” 在转换以双引号开始的数据时报告错误（＂)．如果不应引用该字段，请使用此设置。

例子：如果'批批'被设定为“删除”，则导入函数导入“abc”def“作为六边形abcdef”．

数据类型：字符|一串

`“空场”`- - - - - -管理空字段的操作步骤
`“失踪”`（默认）|`“错误”`|`“汽车”`

过程管理数据中的空字段，指定为以下值之一：

“失踪”-使用中指定的步骤丢失规则财产
“错误”-使用中指定的步骤进口许可证财产

“汽车”—根据变量的数据类型使用空值

数据类型	空价值
`文本`	零长度`字符`或者`一串`
`数字`	`南`对于浮点数 `0`对于整数
`持续时间`	`南`
`datetime`	`NaT`
`逻辑`	`假`
`分类`	`<定义>`

例子：选择= setvaropts(选择,‘RestorationTime’,‘EmptyFieldRule’,‘汽车’);

数据类型：字符|一串

`“前缀”`- - - - - -要从前缀位置删除的文本
特征向量|字符向量单元数组|字符串标量|字符串数组

从变量值的前缀位置删除文本，指定为字符向量，字符向量，字符串标量或字符串数组的单元格数组。

例子：选择= setvaropts(“Var1”,选择“前缀”,“美元”)设置前缀变量的选项Var1. 如果Var1包含值为“500美元”,然后readtable读它“500”．

数据类型：字符|一串|细胞

`“后缀”`- - - - - -要从后缀位置删除的文本
特征向量|字符向量单元数组|字符串标量|字符串数组

从变量值的后缀位置删除文本，指定为字符向量，字符向量，字符串标量或字符串数组的单元格数组。

例子：选择= setvaropts(“Var1”,选择“后缀”,/ -)设置后缀变量的选项Var1. 如果Var1包含值为“500美元/ -”,然后readtable读它“500美元”．

数据类型：字符|一串|细胞

文本变量选择

全部折叠

`“空白规则”`- - - - - -管理前导和尾随空格的过程
`“修剪”`（默认）|`“trimleading”`|`“trimtrailing”`|`'保存'`

过程来管理导入文本数据时的前导和尾随空格，这些空格被指定为表中的值之一。

白色空间规则	过程
`“修剪”`	从文本中删除任何前导或尾随空格。内部空白不受影响。例子：`“世界时间”`作为进口`“世界时间”`
`“trimleading”`	仅删除前导空格。例子：`“世界时间”`作为进口`“世界时间”`
`“trimtrailing”`	只删除尾随的白色空间。例子：`“世界时间”`作为进口`“世界时间”`
`'保存'`	保护白色空间。例子：`“世界时间”`作为进口`“世界时间”`

数据类型：字符|一串

数字变量选项

全部折叠

`“ExponentCharacter”`- - - - - -字符显示指数
特征向量|字符串标量

表示指数的字符，指定为字符向量或字符串标量。导入函数使用ExponentCharacter属性识别用科学记数法表示的数字的指数的字符。

例子：如果varOpts。ExponentCharacter = ' '，然后导入函数导入文本“1.2a3”数量1200．

数据类型：字符|一串

`“DecimalSeparator”`- - - - - -十进制分隔符
特征向量|字符串标量

表示数字变量中的十进制分隔符的字符，指定为字符向量或字符串标量。导入函数使用指定的字符decimalseparator.名称-值对，用来区分数字的整数部分和小数部分。

在转换为整数数据类型时，带有小数部分的数字将四舍五入到最接近的整数。

例子：如果将名称值对指定为“DecimalSeparator”、“,”，然后导入函数导入文本“3,14159”数量3.14159.．

数据类型：字符|一串

`“ThousandsSeparator”`- - - - - -字符表示成千上万的分组
特征向量|字符串标量

表示在数字变量中分组的数千个字符，指定为字符向量或字符串标量。数千个分组字符充当视觉分离器，在每三个位置计算数字。导入函数使用指定的字符千分之二名称-值对用于解释导入的数字。

例子：如果将名称值对指定为“千分之二”，然后导入函数导入文本“1234000”作为1234000．

数据类型：字符|一串

`“TrimNonNumeric”`- - - - - -删除非数字字符
`假`（默认）|`真的`

从作为逻辑指定的数字变量中删除非数字字符真的或者假．

例子：如果将名称值对指定为“TrimNonNumeric”,真的，然后导入功能读取“500美元/ -”作为500．

数据类型：逻辑

`“NumberSystem”`- - - - - -数值变量解释系统
`“小数”`（默认）|`'六角'`|`'二进制'`

用于解释数值变量的系统，指定为“小数”，'六角'，或者'二进制'．

的价值`“NumberSystem”`	描述
`“小数”`	将输入的数值变量视为具有十进制值。将值解释为具有由`'类型'`名称-值对,或者`“双”`如果`'类型'`未指定。
`'六角'`	将输入数值变量视为具有十六进制(16进制)值。输入值可以有`“0 x”`或者`“0 x”`作为前缀，但前缀不是必需的。将值解释为具有由`'类型'`名称-值对。
`'二进制'`	将输入数值变量视为具有二进制(以2为基数)值。输入值可以有`“0b”`或者`'0B'`作为前缀，但前缀不是必需的。将值解释为具有由`'类型'`名称-值对。

逻辑变量选项

全部折叠

`'truesymbols'`- - - - - -要视为逻辑值的文本`真的`
特征向量|字符串标量|字符向量单元数组|字符串数组

作为逻辑值处理的文本真的，指定为字符向量，字符串标量，字符向量的单元格数组，或字符串数组。

例子：如果varOpts。TrueSymbols ={“t”,“真正的”}，然后导入函数导入包含的任何字段t或者真的作为逻辑值真的．

数据类型：字符|一串|细胞

`“虚假符号”`- - - - - -要视为逻辑值的文本`假`
特征向量|字符串标量|字符向量单元数组|字符串数组

作为逻辑值处理的文本假，指定为字符向量，字符串标量，字符向量的单元格数组，或字符串数组。

例子：如果varopts.falsesymbols = {'f'，'false'}，然后导入函数导入包含的任何字段f或者错误的作为逻辑值假．

数据类型：字符|一串|细胞

`“CaseSensitive”`- - - - - -匹配案例的指标
`真的`|`假`

指示符以匹配大小写，指定为逻辑值真的或者假．

要将输入数据解释为丢失，真的，或者假，导入函数将数据与指定的值匹配治疗减少，真实符号，和FalseSymbols．

Datetime变量选择

全部折叠

`“DatetimeFormat”`- - - - - -显示格式
`“默认”`|`“defaultdate”`|`“preserveinput”`|自定义格式|特征向量|字符串标量

显示格式，指定为字符向量或字符串标量。的DatetimeFormat属性控制输出中的日期和时间的显示格式。具体说明DatetimeFormat作为这些价值观之一。

的价值`DatetimeFormat`	描述
`“默认”`	使用默认的显示格式。
`“defaultdate”`	使用没有时间组件创建的DateTime值的默认显示格式。
`“preserveinput”`	使用输入格式指定的格式，`InputFormat.`．
自定义格式	使用字母`无所不包的`和`无所不包的`为构造自定义值的步骤`DatetimeFormat`．这些字母对应于Unicode^®地区数据标记语言(LDML)用于日期的标准。可以使用非ascii或非字母字符，如连字符、空格或冒号来分隔字段。包括信件`无所不包的`和`无所不包的`作为格式的文字字符，用单引号括起来。

出厂默认格式取决于您的系统区域设置。要更改默认显示格式，请参阅默认的datetime格式．

数据类型：字符|一串

`“InputFormat”`- - - - - -输入文本的格式
特征向量|字符串标量

表示日期和时间的输入文本的格式，指定为包含字母标识符的字符向量或字符串标量。

此表显示了几种常见的输入格式和日期的格式输入的示例，2014年4月19日星期六在纽约市中令9:41:06。

的价值`InputFormat.`	例子
`“yyyy-MM-dd”`	`2014-04-19`
`'dd / mm / yyyy'`	`19/04/2014`
`“dd.MM.yyyy”`	`19.04.2014`
`“yyyy年MM月dd日”`	`2014年 04月 19日`
`“嗯，嗯，yyyy”`	`2014年4月19日`
`'EEEE，MMMM D，YYYY H：MM A'`	`2014年4月19日，星期六，晚上9:41`
`' mm d, yyyy HH:mm:ss Z'`	`2014年4月19日21:41:06 -0400`
`'yyyy-mm-dd''t''hh：mmxxx'`	`2014 - 04 - 19 - t21:41内`

有关有效字母标识符的完整列表，请参阅格式属性用于datetime数组。

例子：“InputFormat”，“eeee，MMMM d，yyyy HH:mm:ss”

数据类型：字符|一串

`'dateTimelocale'`- - - - - -解释日期的区域设置
特征向量|字符串标量

语言环境解释日期，指定为字符向量或字符串标量。的dateTimelocale.值决定导入函数如何解释表示日期和时间的文本。

设定dateTimelocale.对于其中一个值：

“系统”- 指定系统区域设置。
字符向量或字符串标量-使用XX.＿YY哪里XX.是小写的ISO 639-1两个字母的代码，它指定了一种语言，并且YY是一个大写ISO 3166-1 Alpha-2代码，用于指定一个国家/地区。

此表列出了区域设置的一些常用值。

地区	语言	国
`'de_de'`	德语	德国
`“en_GB”`	英语	大不列颠联合王国
`'en_us'`	英语	美国
`“es_ES”`	西班牙语	西班牙
`'fr_fr'`	法国	法国
`“它!”`	意大利人	意大利
`'ja_jp'`	日本	日本
`'ko_kr'`	韩国人	韩国
`“设置nl_NL”`	荷兰人	荷兰
`'zh_cn'`	中文（简体）	中国

例子：varOpts。Datetime地区= 'de_DE'将日期时间区域设置为德语。

请注意

的地区值决定如何解释输入值。显示格式和语言由地区选项在Datetime格式首选项窗口的部分。要更改默认的DateTime语言环境，请参阅设置命令窗口首选项．

数据类型：字符|一串

`“时区”`- - - - - -时区
`”`（默认）|特征向量|字符串标量

时区，指定为字符向量或字符串标量。的值时区指定导入功能用于解释输入数据的时区。时区还指定了输出阵列的时区。如果输入数据是包含时区的字符向量，则导入函数将所有值转换为指定的时区。

时区使用以下任一值：

”，创建不属于特定时区的“unzoning”datetime值。
IANA时区数据库中的时区区域;例如,“美国/洛杉矶”．时区区域的名称说明了在一个地理区域中观察到的与UTC的标准和日光偏移量的当前和历史规则。
格式的ISO 8601字符向量+ HH: mm或者-嗯．例如,'+01：00'，指定来自UTC的固定偏移量的时区。
UTC的，以在通用协调时间中创建日期时间值。
“UTCLeapSeconds”，以在通用协调时间中创建包含闰秒的datetime值。

此表列出了IANA时区数据库中的一些常见时区名称。

的价值`时区`	UTC偏移	UTC DST抵消
`'非洲/约翰内斯堡'`	+ 02:00	+ 02:00
`“美国/芝加哥”`	−06:00	-05：00
`'美国/丹佛'`	-07：00	−06:00
`“美国/洛杉矶”`	−喂饲	-07：00
`“美国/纽约”`	-05：00	−04:00
`“美国/ Sao_Paulo”`	-03：00	-02：00
`“亚洲/ Hong_Kong”`	+喂饲	+喂饲
`'亚洲/加尔各答'`	+05：30	+05：30
`'亚洲/东京'`	+09:00	+09:00
`“澳大利亚/悉尼”`	+10:00	+ 11点
`“欧洲/伦敦”`	+ 00:00	+ 01:00
`“欧洲/苏黎世”`	+ 01:00	+ 02:00

没有指定日期的日期时间数组时区不能与具有其属性的数组进行比较或组合时区属性设置为特定时区。

数据类型：字符|一串

分类变量的选择

全部折叠

`'类别'`- - - - - -预期的类别
字符向量单元数组|字符串数组

期望的类别，指定为字符向量的单元格数组或包含类别名称列表的字符串数组。

输入字段中的名称必须与指定的名称之一匹配类别属性避免转换错误。

例子：varOpts。类别={‘BareLand’,‘森林’,‘水’,‘道路’,‘建筑’};

`“保护”`- - - - - -类别保护指示器
`真的`|`假`

类别保护指标，指定为逻辑真的或者假．序数类别数组的类别总是受保护的。如果序数属性设置为真的，则为默认值受保护的是真的。否则受保护的是假．有关分类阵列的更多信息，请参阅分类函数引用页面。

`“顺序”`- - - - - -数学要求指标
`假`（默认）|`真的`|`0`|`1`

数学排序指示器，指定为假，真的，0，或者1．有关分类阵列的更多信息，请参阅分类函数引用页面。

持续时间变量选项

全部折叠

`“InputFormat”`- - - - - -输入文本的格式
特征向量|字符串标量

表示持续时间数据的输入文本的格式，指定为字符向量或字符串数组。

具体说明InputFormat.作为以下任何一种格式，其中dd，hh，毫米，和SS.分别表示天、小时、分钟和秒:

'dd：hh：mm：ss'
'hh：mm：ss'
mm: ss的
“hh: mm”
前三种格式之一，最多九种年代表示小数位数的字符，例如“hh: mm: ss。瑞士的

例子：varOpts。InputFormat =“dd: hh: mm: ss”

数据类型：字符|一串

`“DurationFormat”`- - - - - -显示格式的持续时间数据
特征向量|字符串标量

持续时间数据的显示格式，指定为字符向量或字符串标量。

对于带有时间单位的数字，指定以下值之一:

“y”- 固定长度，1年等于365.2425天
'D'- 固定长度，1天等于24小时
'H'- 小时
'M'- 分钟
“年代”-秒

对于数字计时器，请指定以下格式之一：

'dd：hh：mm：ss'
'hh：mm：ss'
mm: ss的
“hh: mm”
前三种格式之一，最多九种年代表示小数位数的字符，例如“hh: mm: ss。瑞士的

例子：DurationFormat可以是一个数字单位的单个数字（例如0.5年)或数字计时器(如10:30:1510小时30分钟15秒)。

数据类型：字符|一串

`“DecimalSeparator”`- - - - - -分隔小数秒的字符
`．`（默认）|特征向量|字符串标量

分隔分数秒的字符，指定为字符向量或字符串标量。导入函数使用decimalseparator.属性以区分持续时间值的整数部分和小数秒部分。

数据类型：字符|一串

`'fieldseparator'`- - - - - -字段分隔符
`：`（默认）|特征向量|字符串标量

表示持续时间数据中的字段分离的字符，指定为字符向量或字符串标量。

数据类型：字符|一串

另请参阅

检测端口选项|getVaropts.|预览|setvartype

介绍了R2016b

setvaropts

语法

描述

例子

设置选定变量的选项

设置“包含缺失或不完整记录的数字数据”选项

设置十六进制和二进制数的选项

导入文本数据时设置选项

导入逻辑数据时设置选项

导入日期和时间数据

导入分类数据时设置选项

从变量中删除前缀或后缀字符

管理空字段的导入

输入参数

选择- - - - - -文件导入选项SpreadSheetimportOptions.|DelimitedTextImportOptions|多个沃特莫特选项

选择- - - - - -选择变量特征向量|字符串标量|字符向量的单元格数组|字符串数组|一系列索引|逻辑阵列

名称-值对的观点

'类型'- - - - - -数据类型的变量“char”|“字符串”|“单身”|“双”|“int8”|“int16”|...

“FillValue”- - - - - -缺失数据的替换值特征向量|字符串标量|标量数值|真的|假

“TreatAsMissing”- - - - - -要解释为缺少数据的文本特征向量|字符串标量|字符向量单元数组|字符串数组

'批批'- - - - - -管理双引号的过程“删除”|'保持'|“错误”

“空场”- - - - - -管理空字段的操作步骤“失踪”（默认）|“错误”|“汽车”

“前缀”- - - - - -要从前缀位置删除的文本特征向量|字符向量单元数组|字符串标量|字符串数组

“后缀”- - - - - -要从后缀位置删除的文本特征向量|字符向量单元数组|字符串标量|字符串数组

“空白规则”- - - - - -管理前导和尾随空格的过程“修剪”（默认）|“trimleading”|“trimtrailing”|'保存'

“ExponentCharacter”- - - - - -字符显示指数特征向量|字符串标量

“DecimalSeparator”- - - - - -十进制分隔符特征向量|字符串标量

“ThousandsSeparator”- - - - - -字符表示成千上万的分组特征向量|字符串标量

“TrimNonNumeric”- - - - - -删除非数字字符假（默认）|真的

“NumberSystem”- - - - - -数值变量解释系统“小数”（默认）|'六角'|'二进制'

'truesymbols'- - - - - -要视为逻辑值的文本真的特征向量|字符串标量|字符向量单元数组|字符串数组

“虚假符号”- - - - - -要视为逻辑值的文本假特征向量|字符串标量|字符向量单元数组|字符串数组

“CaseSensitive”- - - - - -匹配案例的指标真的|假

“DatetimeFormat”- - - - - -显示格式“默认”|“defaultdate”|“preserveinput”|自定义格式|特征向量|字符串标量

“InputFormat”- - - - - -输入文本的格式特征向量|字符串标量

'dateTimelocale'- - - - - -解释日期的区域设置特征向量|字符串标量

“时区”- - - - - -时区”（默认）|特征向量|字符串标量

'类别'- - - - - -预期的类别字符向量单元数组|字符串数组

“保护”- - - - - -类别保护指示器真的|假

“顺序”- - - - - -数学要求指标假（默认）|真的|0|1

“InputFormat”- - - - - -输入文本的格式特征向量|字符串标量

“DurationFormat”- - - - - -显示格式的持续时间数据特征向量|字符串标量

“DecimalSeparator”- - - - - -分隔小数秒的字符．（默认）|特征向量|字符串标量

'fieldseparator'- - - - - -字段分隔符：（默认）|特征向量|字符串标量

另请参阅

MATLAB文件

万博1manbetx

与Matlab引入深度学习

`选择`- - - - - -文件导入选项
`SpreadSheetimportOptions.`|`DelimitedTextImportOptions`|`多个沃特莫特选项`

`选择`- - - - - -选择变量
特征向量|字符串标量|字符向量的单元格数组|字符串数组|一系列索引|逻辑阵列

`'类型'`- - - - - -数据类型的变量
`“char”`|`“字符串”`|`“单身”`|`“双”`|`“int8”`|`“int16”`|...

`“FillValue”`- - - - - -缺失数据的替换值
特征向量|字符串标量|标量数值|`真的`|`假`

`“TreatAsMissing”`- - - - - -要解释为缺少数据的文本
特征向量|字符串标量|字符向量单元数组|字符串数组

`'批批'`- - - - - -管理双引号的过程
`“删除”`|`'保持'`|`“错误”`

`“空场”`- - - - - -管理空字段的操作步骤
`“失踪”`（默认）|`“错误”`|`“汽车”`

`“前缀”`- - - - - -要从前缀位置删除的文本
特征向量|字符向量单元数组|字符串标量|字符串数组

`“后缀”`- - - - - -要从后缀位置删除的文本
特征向量|字符向量单元数组|字符串标量|字符串数组

`“空白规则”`- - - - - -管理前导和尾随空格的过程
`“修剪”`（默认）|`“trimleading”`|`“trimtrailing”`|`'保存'`

`“ExponentCharacter”`- - - - - -字符显示指数
特征向量|字符串标量

`“DecimalSeparator”`- - - - - -十进制分隔符
特征向量|字符串标量

`“ThousandsSeparator”`- - - - - -字符表示成千上万的分组
特征向量|字符串标量

`“TrimNonNumeric”`- - - - - -删除非数字字符
`假`（默认）|`真的`

`“NumberSystem”`- - - - - -数值变量解释系统
`“小数”`（默认）|`'六角'`|`'二进制'`

`'truesymbols'`- - - - - -要视为逻辑值的文本`真的`
特征向量|字符串标量|字符向量单元数组|字符串数组

`“虚假符号”`- - - - - -要视为逻辑值的文本`假`
特征向量|字符串标量|字符向量单元数组|字符串数组

`“CaseSensitive”`- - - - - -匹配案例的指标
`真的`|`假`

`“DatetimeFormat”`- - - - - -显示格式
`“默认”`|`“defaultdate”`|`“preserveinput”`|自定义格式|特征向量|字符串标量

`“InputFormat”`- - - - - -输入文本的格式
特征向量|字符串标量

`'dateTimelocale'`- - - - - -解释日期的区域设置
特征向量|字符串标量

`“时区”`- - - - - -时区
`”`（默认）|特征向量|字符串标量

`'类别'`- - - - - -预期的类别
字符向量单元数组|字符串数组

`“保护”`- - - - - -类别保护指示器
`真的`|`假`

`“顺序”`- - - - - -数学要求指标
`假`（默认）|`真的`|`0`|`1`

`“InputFormat”`- - - - - -输入文本的格式
特征向量|字符串标量

`“DurationFormat”`- - - - - -显示格式的持续时间数据
特征向量|字符串标量

`“DecimalSeparator”`- - - - - -分隔小数秒的字符
`．`（默认）|特征向量|字符串标量

`'fieldseparator'`- - - - - -字段分隔符
`：`（默认）|特征向量|字符串标量