setvaropts

设置变量导入选项

折叠所有页面

语法

选择= setvaropts(选择、名称、值)

选择= setvaropts(选择、选择、名称、值)

描述

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

例子

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

例子

全部折叠

为选定的变量设置选项

打开生活的脚本

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

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

选择= detectImportOptions (“patients.xls”）;

设置FillValue财产吸烟者，舒张压,收缩压变量。

选择= setvaropts(选择,“抽烟”，“FillValue”、假);选择= setvaropts(选择,{舒张压的，“收缩”}，“FillValue”, 0);

选择要导入的变量。

选择。年代electedVariableNames = {“抽烟”，舒张压的，“收缩”};

导入变量并显示摘要。

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和DepDelay，其中包含由NA．

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

选择= detectImportOptions (“airlinesmall.csv”）;

使用TreatAsMissing属性指定数据中作为缺失实例的占位符的字符。在这个例子中，两个数值变量ArrDelay和DepDelay包含包含文本的缺失字段NA．

选择= setvaropts(选择,{“ArrDelay”，“DepDelay”}，“TreatAsMissing”，“NA”）;

指定导入函数在导入缺失实例时要采取的操作。看到ImportOptions属性页以获得更多选项。

选择。MissingRule =“填满”；

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

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

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

选择。年代electedVariableNames = {“ArrDelay”，“DepDelay”};T = readtable (“airlinesmall.csv”、选择);

检查ArrDelay和DepDelay．验证导入函数是否替换了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参数自动检测十六进制和二进制数0 x和0 b前缀。若要在这些数字没有前缀时导入它们，请使用导入选项对象。

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

选择= detectImportOptions (“hexAndBinary.txt”）

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'， 'char'…{'Var1'， 'Var2'， 'Var3'…和1}VariableOptions:显示所有4 VariableOptions访问VariableOptions sub-properties使用setvaropts / getvaropts VariableNamingRule:“修改”位置属性:DataLines:[1正]VariableNamesLine: 0 RowNamesColumn: 0 VariableUnitsLine: 0 VariableDescriptionsLine: 0显示表的预览,预览使用

要指定第三列应该作为十六进制值导入，尽管没有前缀，请使用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: Variable properties: Name: 'LastName' Type: 'char' FillValue: " TreatAsMissing: {} QuoteRule: 'remove' Prefixes: {} suffix: {} emptyfieldrole: 'missing' String Options: WhitespaceRule: 'trim'

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

选择= setvartype(选择,“姓”，“字符串”）;

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

选择= setvaropts(选择,“姓”，“FillValue”，“无名”）;

选择、读取并显示变量的前10行预览。

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

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

导入逻辑数据时设置选项

打开生活的脚本

使用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'

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

选择= setvartype(选择,“取消”，“逻辑”）;

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

选择= setvaropts(选择,“取消”，“FillValue”,真正的);

选择、读取并显示变量的摘要。

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

变量:取消:1338x1逻辑值:True 29 False 1309

导入日期和时间数据

打开生活的脚本

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

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

获取导入选项对象。

选择= detectImportOptions (“outages.csv”）;

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

varOpts = getvaropts(选择,{“OutageTime”，“RestorationTime”}）

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

设置FillValue属性，以使用当前日期和时间替换缺失的值。

选择= setvaropts(选择,{“OutageTime”，“RestorationTime”}，．..“FillValue”，“现在”）;

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

选择。年代electedVariableNames = {“OutageTime”，“RestorationTime”};T = readtable (“outages.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-09-01 10:53 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函数。

预览中的数据outages.csv．注意列中的分类数据地区和导致．该表只显示了前10行。

获取导入选项对象。

选择= detectImportOptions (“outages.csv”）;

获取并检查变量的选项地区和导致．

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

ans = 1x2 TextVariableImportOptions数组的属性:Name Type FillValue TreatAsMissing QuoteRule Prefixes suffix emptyfieldrole WhitespaceRule

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

选择= setvartype(选择,{“地区”，“原因”}，“分类”）;

设置FillValue属性，以使用类别名称替换缺失的值“杂项”．集TreatAsMissing财产“未知”．

选择= setvaropts(选择,{“地区”，“原因”}，．..“FillValue”，“杂项”，．..“TreatAsMissing”，“未知”）;

选择、读取并显示这两个变量的摘要。

选择。年代electedVariableNames = {“地区”，“原因”};T = readtable (“outages.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”；选择= detectImportOptions(文件名);预览(文件名,选择)

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'

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

选择。年代electedVariableNames = {“时间”，“Total_Fees”，“温度”};选择= setvartype(选择,“时间”，“datetime”）;选择= setvaropts(选择,“时间”，“InputFormat”，“MM / dd / uu HH: MM”）;%指定日期时间格式选择= setvartype(选择,{“Total_Fees”，“温度”}，“双”）;getvaropts(选择,{“时间”，“Total_Fees”，“温度”}）

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

设置前缀，后缀,TrimNonNumeric要删除的变量导入选项的属性的时间戳:从变量时间、删除后缀“C”从变量温度，并从变量中删除所有非数字字符Total_Fees．使用新的导入选项预览表。

选择= setvaropts(选择,“时间”，“前缀”，的时间戳:）;选择= setvaropts(选择,“温度”，“后缀”，“C”）;选择= setvaropts(选择,“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获取所有变量并导入数据。

为包含空字段的文件创建导入选项对象。属性获取表的前8行预览函数。的默认值EmptyFieldRule是“失踪”．因此，导入函数将空字段视为缺失，并用FillValue这个变量的值。使用VariableOptions对于第三个变量，预览数据。在这里,预览函数将第三个变量中的空字段导入为南年代。

文件名=“DataWithEmptyFields.csv”；选择= detectImportOptions(文件名);opts.VariableOptions (3)%显示第三个变量的变量选项

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

预览(文件名,选择)

ans =8×7表文本分类双Datetime逻辑时间字符串  __________ ___________ ______ __________ __________ ________ __________ {' abc '} {a} 1 01/14/0018{“真实”}00:00:01 {' abc '} {0 x0 char} {b} 2 01/21/0018{“假”}09:00:01{“def”}{“酥油”}{0 x0 char} 3 01/31/0018{“真实”}02:00:01{“酥油”}{. jkl的}{a}南02/23/2018{“假”}03:00:01 {. jkl的}{‘mno} {a} 4 NaT{“假”}04:00:01{‘mno}{‘pqr} {b} 5 01/23/0018 {0 x0 char} 05:00:01{‘pqr}{“斯图”}{b} 5 03/23/0018{“假”}南{“斯图”}{0 x0 char} {a} 6 03/24/2018{“真实”}07:00:01 {0 x0 char}

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

选择。年代electedVariableNames =“分类”；选择= setvartype(选择,“分类”，“分类”）;选择= setvaropts(选择,“分类”，“EmptyFieldRule”，“汽车”）;T = readtable(文件名,选择)

T =10×1表分类___________ a b  a a b b a a

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

VariableNames = opts.VariableNames;选择。年代electedVariableNames = VariableNames;选择所有变量选择= setvartype(选择,{“逻辑”，“字符串”}，{“逻辑”，“字符串”}）;选择= setvaropts (VariableNames选择,“EmptyFieldRule”，“汽车”）;T = readtable(文件名,选择)

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方法中指定的过程将导入空字段ImportErrorRule参数。

输入参数

全部折叠

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

文件导入选项，指定为SpreadsheetImportOptions，DelimitedTextImportOptions,或者一个FixedWidthImportOptions对象创建的detectImportOptions函数。的选择对象包含控制数据导入过程的属性，如变量属性、数据位置属性、替换规则等。

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

指定为字符向量、字符串标量、字符向量单元格数组、字符串数组、数字索引数组或逻辑数组的选定变量。

变量名(或下标)必须是包含在VariableNames财产的选择对象。

例子:“高度”

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

例子:9 [5]

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

名称-值参数

指定可选的逗号分隔的对名称,值参数。的名字参数名和价值为对应值。的名字必须出现在引号内。可以以任意顺序指定多个名称和值对参数Name1, Value1,…,的家．

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

所有变量类型的通用选项

全部折叠

`类型`- - - - - -变量的数据类型
`“字符”`|`“字符串”`|`“单一”`|`“双”`|`“int8”`|`“int16”`|……

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

数据类型	描述
`“字符”` `“字符串”`	文本。
`“单一”` `“双”`	单精度或双精度浮点数。
`“int8”`，`“int16”`，`“int32”`，`“int64”` `“uint8”`，`“uint16”`，`“uint32”`，`“uint64”`	有符号或无符号整数，存储为8、16、32或64位整数。整数数据类型没有定义与浮点数对应的值`南`，`负`,`+正`．因此，当您将浮点数据作为整数数组导入时，import函数将转换未定义的浮点数: `南`被转换为`0`． `负`使用?转换为指定整数数据类型的最小整数`intmin`函数。 `+正`使用?转换为指定整数数据类型的最大整数`intmax`函数。
`“逻辑”`	True或false值(例如，`真正的`，`假`，`1`,或`0`)．
`“datetime”`	指定时间点的日期和时间(例如，`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实例设置为当前日期和时间。例子:`12 1] [1998`将缺失的datetime实例设置为1998年12月1日。
持续时间	字符向量或字符串标量，或表示持续时间数据的标量值。查询更多有效信息`持续时间`输入,看到`持续时间`功能页面。例子:`“12:30:16”`将缺少的持续时间实例设置为12小时、30分钟和16秒的持续时间。
分类	包含要用于替换类别的名称的字符向量或字符串标量。例子:`“杂项”`将类别名称Miscellaneous分配给类别数据中缺失的实例。

要直接导入丢失的、不可转换的或导致错误的数据，请同时使用以下四个属性:FillValue，TreatAsMissing，MissingRule,ErrorRule．属性中指定的值FillValue房地产当:

中的数据不可转换或匹配值TreatAsMissing．
MissingRule或者是ErrorRule被设置为填满．

`TreatAsMissing`- - - - - -文本解释为丢失的数据
特征向量|字符串标量|字符向量的单元格数组|字符串数组

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

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

例子:TreatAsMissing,{“NA”,“TBD”}指示导入函数处理任何出现的NA或TBD作为缺失的字段。

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

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

处理以管理数据中的双引号(指定为本表中的值之一)。

引用规则过程

引用规则	过程
`“删除”`	在删除前导空格后，if双引号(`＂`)包围字符，然后导入函数删除开始的双引号和出现的下一个双引号，下一个双引号将被解释为结束的双引号。例子：`”“示例文本`是进口的`示例文本`．例子：`“例子”文本`是进口的`“例子”文本`．如果两组双引号(`＂＂`)包围字符，然后导入函数删除前两个出现的字符。例子：`”“abc”“`是进口的`美国广播公司"`．例子：`“”“例子”文本`是进口的`“例子”文本`．例子：`“例子”“文本”`是进口的`“例子”“文本”`．如果围绕字符的一对开始和结束引号后跟一个单独的未配对的双引号，则导入函数将忽略单独的未配对的双引号。例子：`“abc”“`是进口的`美国广播公司(abc)”`．例子：`“abc“def”`是进口的`六边形abcdef”`．外部双引号中的转义双引号将被单双引号替换。例子：`“例子”“的”“文本”“`是进口的`“例子”“文本”`．
`“保持”`	保留所有的引号。
`“错误”`	转换以双引号开头的数据时报告错误(`＂`)．如果不应该引用字段，请使用此设置。

“删除”

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

例子：”“示例文本是进口的示例文本．

例子：“例子”文本是进口的“例子”文本．

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

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

例子：“”“例子”文本是进口的“例子”文本．

例子：“例子”“文本”是进口的“例子”“文本”．

如果围绕字符的一对开始和结束引号后跟一个单独的未配对的双引号，则导入函数将忽略单独的未配对的双引号。

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

例子：“abc“def”是进口的六边形abcdef”．

外部双引号中的转义双引号将被单双引号替换。

例子：“例子”“的”“文本”“是进口的“例子”“文本”．

“保持”

保留所有的引号。

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

数据类型:字符|字符串

`EmptyFieldRule`- - - - - -管理空字段的操作步骤
`“失踪”`(默认)|`“错误”`|`“汽车”`

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

“失踪”—使用MissingRule财产
“错误”—使用ImportErrorRule财产

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

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

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

数据类型:字符|字符串

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

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

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

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

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

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

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

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

文本变量选择

全部折叠

`WhiteSpaceRule`- - - - - -管理前导和尾随空格的过程
`“修剪”`(默认)|`“trimleading”`|`“trimtrailing”`|`“保存”`

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

空白规则	过程
`“修剪”`	从文本中删除任何前导或尾随空格。内部空白不受影响。例子:`“世界时间”`是进口的`“世界时间”`
`“trimleading”`	只删除前导空白。例子:`“世界时间”`是进口的`“世界时间”`
`“trimtrailing”`	只删除后面的空白。例子:`“世界时间”`是进口的`“世界时间”`
`“保存”`	保留空白。例子:`“世界时间”`是进口的`“世界时间”`

数据类型:字符|字符串

数值变量的选择

全部折叠

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

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

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

数据类型:字符|字符串

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

在数字变量中指示十进制分隔符的字符，指定为字符向量或字符串标量。属性中指定的字符DecimalSeparator名称-值对，用来区分数字的整数部分和小数部分。

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

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

数据类型:字符|字符串

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

在数字变量中指示数以千计分组的字符，指定为字符向量或字符串标量。数以千计的分组字符充当了视觉分隔符，每三个位置的值分组一个数字。属性中指定的字符ThousandsSeparator名称-值对用于解释导入的数字。

例子:如果名称-值对指定为“ThousandsSeparator”、“,”，然后导入函数导入文本“1234000”作为1234000．

数据类型:字符|字符串

`TrimNonNumeric`- - - - - -删除非数字字符
`假`(默认)|`真正的`

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

例子:如果名称-值对指定为“TrimNonNumeric”,真的，则导入函数读取“500美元/ -”作为500．

数据类型:逻辑

`NumberSystem`- - - - - -数值变量解释系统
`“小数”`(默认)|`十六进制的`|`“二元”`

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

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

逻辑变量的选择

全部折叠

`TrueSymbols`- - - - - -将文本作为逻辑值处理`真正的`
特征向量|字符串标量|字符向量的单元格数组|字符串数组

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

例子:如果varOpts。TrueSymbols ={“t”,“真正的”}，则导入函数将导入包含的所有字段t或真正的作为逻辑值真正的．

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

`FalseSymbols`- - - - - -将文本作为逻辑值处理`假`
特征向量|字符串标量|字符向量的单元格数组|字符串数组

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

例子:如果varOpts。FalseSymbols = {' f ', '假'}，则导入函数将导入包含的所有字段f或假作为逻辑值假．

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

`CaseSensitive`- - - - - -匹配指示器
`真正的`|`假`

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

若要将输入数据解释为缺失，真正的,或假，则导入函数将数据与中指定的值匹配TreatAsMissing，TrueSymbols,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日`
`“嗯d, yyyy”`	`2014年4月19日`
`'eee, 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”`	法国	法国
`“it_IT”`	意大利	意大利
`“ja_JP”`	日本	日本
`“ko_KR”`	朝鲜文	韩国
`“设置nl_NL”`	荷兰	荷兰
`“zh_CN”`	中文(简体)	中国

例子:varOpts。Datetime语言环境= 'de_DE'将日期时间设置为德语。

请注意

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

数据类型:字符|字符串

`时区`- - - - - -时区
`”`(默认)|特征向量|字符串标量

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

时区使用这些值中的任何一个:

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

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

的价值`时区`	UTC抵消	UTC DST抵消
`“非洲/约翰内斯堡”`	+ 02:00	+ 02:00
`“美国/芝加哥”`	−06:00时	−凌晨5
`美国/丹佛的`	−07:00	−06:00时
`“美国/ Los_Angeles”`	−喂饲	−07:00
`“美国/ New_York”`	−凌晨5	−内
`“美国/ Sao_Paulo”`	−03:00	−02:00
`“亚洲/ Hong_Kong”`	+喂饲	+喂饲
`“亚洲/加尔各答”`	+ 05:30	+ 05:30
`“亚洲/东京”`	上午9点+	上午9点+
`“澳大利亚/悉尼”`	+ 10点	+ 11点
`“欧洲/伦敦”`	+ 00:00	+ 01:00
`“欧洲/苏黎世”`	+ 01:00	+ 02:00

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

数据类型:字符|字符串

分类变量的选择

全部折叠

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

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

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

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

`受保护的`- - - - - -类别保护指示器
`真正的`|`假`

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

`序数`- - - - - -数学要求指标
`假`(默认)|`真正的`|`0`|`1`

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

时间变量的选择

全部折叠

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

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

指定InputFormat作为下列任何一种格式，其中dd，hh，毫米,党卫军分别表示天、小时、分钟和秒:

“弟弟: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”- - - - - -小时
“米”- - - - - -分钟
“年代”- - - - - -秒

对于数字定时器，指定以下格式之一:

“弟弟:hh: mm: ss”
“hh: mm: ss”
mm: ss的
“hh: mm”
前三种格式中的任何一种，最多九种年代表示小数位数的字符，例如“hh: mm: ss。瑞士的

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

数据类型:字符|字符串

`DecimalSeparator`- - - - - -分秒字符
`．`(默认)|特征向量|字符串标量

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

数据类型:字符|字符串

`FieldSeparator`- - - - - -字段分隔符
`：`(默认)|特征向量|字符串标量

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

数据类型:字符|字符串

另请参阅

detectImportOptions|getvaropts|setvartype|预览

介绍了R2016b

setvaropts

语法

描述

例子

为选定的变量设置选项

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

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

导入文本数据时设置选项

导入逻辑数据时设置选项

导入日期和时间数据

导入分类数据时设置选项

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

管理空字段的导入

输入参数

选择- - - - - -文件导入选项SpreadsheetImportOptions|DelimitedTextImportOptions|FixedWidthImportOptions

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

名称-值参数

类型- - - - - -变量的数据类型“字符”|“字符串”|“单一”|“双”|“int8”|“int16”|……

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

TreatAsMissing- - - - - -文本解释为丢失的数据特征向量|字符串标量|字符向量的单元格数组|字符串数组

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

EmptyFieldRule- - - - - -管理空字段的操作步骤“失踪”(默认)|“错误”|“汽车”

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

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

WhiteSpaceRule- - - - - -管理前导和尾随空格的过程“修剪”(默认)|“trimleading”|“trimtrailing”|“保存”

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

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

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

TrimNonNumeric- - - - - -删除非数字字符假(默认)|真正的

NumberSystem- - - - - -数值变量解释系统“小数”(默认)|十六进制的|“二元”

TrueSymbols- - - - - -将文本作为逻辑值处理真正的特征向量|字符串标量|字符向量的单元格数组|字符串数组

FalseSymbols- - - - - -将文本作为逻辑值处理假特征向量|字符串标量|字符向量的单元格数组|字符串数组

CaseSensitive- - - - - -匹配指示器真正的|假

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

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

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

时区- - - - - -时区”(默认)|特征向量|字符串标量

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

受保护的- - - - - -类别保护指示器真正的|假

序数- - - - - -数学要求指标假(默认)|真正的|0|1

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

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

DecimalSeparator- - - - - -分秒字符．(默认)|特征向量|字符串标量

FieldSeparator- - - - - -字段分隔符：(默认)|特征向量|字符串标量

另请参阅

MATLAB的文档

金宝app

介绍基于MATLAB的深度学习

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

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

`类型`- - - - - -变量的数据类型
`“字符”`|`“字符串”`|`“单一”`|`“双”`|`“int8”`|`“int16”`|……

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

`TreatAsMissing`- - - - - -文本解释为丢失的数据
特征向量|字符串标量|字符向量的单元格数组|字符串数组

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

`EmptyFieldRule`- - - - - -管理空字段的操作步骤
`“失踪”`(默认)|`“错误”`|`“汽车”`

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

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

`WhiteSpaceRule`- - - - - -管理前导和尾随空格的过程
`“修剪”`(默认)|`“trimleading”`|`“trimtrailing”`|`“保存”`

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

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

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

`TrimNonNumeric`- - - - - -删除非数字字符
`假`(默认)|`真正的`

`NumberSystem`- - - - - -数值变量解释系统
`“小数”`(默认)|`十六进制的`|`“二元”`

`TrueSymbols`- - - - - -将文本作为逻辑值处理`真正的`
特征向量|字符串标量|字符向量的单元格数组|字符串数组

`FalseSymbols`- - - - - -将文本作为逻辑值处理`假`
特征向量|字符串标量|字符向量的单元格数组|字符串数组

`CaseSensitive`- - - - - -匹配指示器
`真正的`|`假`

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

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

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

`时区`- - - - - -时区
`”`(默认)|特征向量|字符串标量

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

`受保护的`- - - - - -类别保护指示器
`真正的`|`假`

`序数`- - - - - -数学要求指标
`假`(默认)|`真正的`|`0`|`1`

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

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

`DecimalSeparator`- - - - - -分秒字符
`．`(默认)|特征向量|字符串标量

`FieldSeparator`- - - - - -字段分隔符
`：`(默认)|特征向量|字符串标量