setvaropts

设置变量导入选项

折叠所有页面

语法

opts = setvaropts(选项，名称，值)

opts = setvaropts(选项，选择，名称，值)

描述

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

例子

选择= setvaropts (选择，选择，名称,值）更新和返回选择属性中指定的变量选择参数中的规范名称,值参数。

例子

全部折叠

为已选变量设置选项

打开实时脚本

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

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

opts = detectImportOptions(“patients.xls”）;

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

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

选择要导入的变量。

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

导入变量并显示摘要。

T =可读的(“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．

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

opts = 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 =可读的(“airlinesmall.csv”、选择);

检查中的值ArrDelay而且DepDelay．验证导入函数是否替换了所表示的缺失值NA．

T (166:180:)

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

设置“十六进制数”和“二进制数”选项

打开实时脚本

的readtable函数自动检测十六进制数和二进制数0 x而且0 b前缀。要在这些数字没有前缀时导入它们，请使用import options对象。

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

opts = detectImportOptions(“hexAndBinary.txt”）

opts = DelimitedTextImportOptions带属性:格式属性:分隔符:{'，'}空白:'\b\t ' LineEnding: {'\n' '\r' '\r\n'} CommentStyle: {} ConsecutiveDelimitersRule: 'split' LeadingDelimitersRule: 'keep' TrailingDelimitersRule: 'ignore' EmptyLineRule: 'skip' Encoding: 'UTF-8'替换属性:MissingRule: 'fill' ImportErrorRule: 'fill' ExtraColumnsRule: 'addvars'变量导入属性:按名称设置类型setvartype VariableNames: {'Var1'， 'Var2'， 'Var3'…{'auto'， 'auto'， 'char'…SelectedVariableNames: {'Var1'， 'Var2'， 'Var3'…使用setvaropts/getvaropts VariableNamingRule: 'modify'位置属性:DataLines: [1 Inf] VariableNamesLine: 0 RowNamesColumn: 0 VariableUnitsLine: 0 VariableDescriptionsLine: 0要显示表格的预览，使用preview

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

选项= setvaropts(选项，3，“NumberSystem”，十六进制的，“类型”，“int32”）

opts = DelimitedTextImportOptions带属性:格式属性:分隔符:{'，'}空白:'\b\t ' LineEnding: {'\n' '\r' '\r\n'} CommentStyle: {} ConsecutiveDelimitersRule: 'split' LeadingDelimitersRule: 'keep' TrailingDelimitersRule: 'ignore' EmptyLineRule: 'skip' Encoding: 'UTF-8'替换属性:MissingRule: 'fill' ImportErrorRule: 'fill' ExtraColumnsRule: 'addvars'变量导入属性:按名称设置类型setvartype VariableNames: {'Var1'， 'Var2'， 'Var3'…变量类型:{'auto'， 'auto'， 'int32'…SelectedVariableNames: {'Var1'， 'Var2'， 'Var3'…使用setvaropts/getvaropts VariableNamingRule: 'modify'位置属性:DataLines: [1 Inf] VariableNamesLine: 0 RowNamesColumn: 0 VariableUnitsLine: 0 VariableDescriptionsLine: 0要显示表格的预览，使用preview

读取文件并将前三列作为数值导入。的readtable函数自动检测第一列和第二列包含十六进制值和二进制值。import options对象指定第三列还包含十六进制值。

T =可读的(“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行的预览。

获取导入选项对象。

opts = detectImportOptions(“patients.xls”）;

获取并检查VariableImportOptions为变量姓．

getvaropts(选择,“姓”）

ans = TextVariableImportOptions与属性:变量属性:名称:'LastName'类型:'char' FillValue: " TreatAsMissing: {} QuoteRule: 'remove'前缀:{}后缀:{}EmptyFieldRule: 'missing'字符串选项:WhitespaceRule: 'trim'

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

Opts = setvartype(选项，“姓”，“字符串”）;

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

Opts = setvaropts(选项，“姓”，“FillValue”，“无名”）;

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

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

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

导入逻辑数据时设置选项

打开实时脚本

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

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

获取导入选项对象。

opts = detectImportOptions(“airlinesmall_subset.xlsx”）;

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

getvaropts(选择,“取消”）

ans = NumericVariableImportOptions与属性:变量属性:名称:'取消'类型:'双' FillValue: NaN TreatAsMissing: {} QuoteRule: '删除'前缀:{}后缀:{}EmptyFieldRule: '失踪'数字选项:指数字符:'eEdD'小数分隔符:'。'" TrimNonNumeric: 0 NumberSystem: 'decimal'

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

Opts = setvartype(选项，“取消”，“逻辑”）;

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

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

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

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

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

导入日期和时间数据

打开实时脚本

使用DatetimeVariableImportOptions控件的导入datetime数据。首先，获取ImportOptions对象。接下来，检查和更新VariableImportOptions对于datetime变量。最后，使用导入变量readtable．

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

获取导入选项对象。

opts = detectImportOptions(“outages.csv”）;

获取并检查VariableImportOptions对于datetime变量OutageTime而且RestorationTime．

varOpts = getvaropts(opts，{“OutageTime”，“RestorationTime”})

varOpts = 1x2 DatetimeVariableImportOptions数组，具有属性:名称类型FillValue TreatAsMissing QuoteRule Prefixes suffix EmptyFieldRule DatetimeFormat DatetimeLocale TimeZone InputFormat

设置FillValue属性将缺失的值替换为当前日期和时间。

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

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

选择。年代electedVariableNames = {“OutageTime”，“RestorationTime”};T =可读的(“outages.csv”、选择);T (1:10,:)

ans =10×2表OutageTime RestorationTime ________________ ________________ 2002-02-01 12:18 2002-02-07 16:09 2004-09-27 16:37

导入分类数据时设置选项

打开实时脚本

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

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

获取导入选项对象。

opts = detectImportOptions(“outages.csv”）;

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

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

ans = 1x2 TextVariableImportOptions数组属性:名称类型FillValue TreatAsMissing QuoteRule Prefixes suffix EmptyFieldRule WhitespaceRule

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

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

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

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

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

选择。年代electedVariableNames = {“地区”，“原因”};T =可读的(“outages.csv”、选择);总结(T)

变量:地区:1468x1分类值:中西部142东北557东南389西南26西部354原因:1468x1分类值:杂项24攻击294地震2能源紧急188设备故障156火灾25强风暴338雷暴201风95冬季风暴145

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

打开实时脚本

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

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

文件名=“pref_suff_trim.csv”；opts = detectImportOptions(文件名);预览(文件名,选择)

ans =8×5表时间DayOfWeek电力Total_Fees温度  _______________________ _______________ ____________ __________ ___________ ' 时间戳:1/1/06 0:00 ' ',太阳% 20 ' ' 54.5448 MW‘$ 1.23“-7.2222 C“时间戳:1/2/06一点' ',Thu %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' '57.9512 MW' '$0.00' '-8.2028 C'

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

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

ans = 1x3带属性的VariableImportOptions数组:变量选项:(1)|(2)|(3)名称:'Time' | 'Total_Fees' | 'Temperature'类型:'datetime' | 'double' | 'double' FillValue: [NaT] | [NaN] | [NaN] TreatAsMissing: {} | {} | {} QuoteRule: 'remove' | 'remove' | 'remove'前缀:{}|{}|{}后缀:{}|{}|{}访问每个变量的子属性，使用getvaropts

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

Opts = setvaropts(选项，“时间”，“前缀”，的时间戳:）;Opts = setvaropts(选项，“温度”，“后缀”，“C”）;Opts = setvaropts(选项，“Total_Fees”，“TrimNonNumeric”,真正的);预览(文件名,选择)

ans =8×3表Time Total_Fees Temperature ______________ __________ ___________ 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(文件名，opts);

管理空字段的导入

打开实时脚本

为包含空字段的文件创建一个导入选项对象。使用EmptyFieldRule参数来管理数据中空字段的导入。首先，预览数据，然后设置EmptyFieldRule参数。最后,设置EmptyFieldRule并导入数据。

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

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

ans = NumericVariableImportOptions带属性:变量属性:名称:'Double'类型:'Double' FillValue: NaN TreatAsMissing: {} QuoteRule: 'remove'前缀:{}后缀:{}EmptyFieldRule: 'missing'数字选项:ExponentCharacter: 'eEdD'小数分隔符:'。'" 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} 503/23/0018 {'FALSE'} NaN {'stu'} {0x0 char} {'a'} 6 03/24/2018 {'TRUE'} 07:00:01 {0x0 char}

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

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

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

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

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

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 NaT假04:00:01 mno“{”pqr} b 5 01/23/0018假05:00:01 pqr“{”斯图}b 5 03/23/0018假南“斯图”{0 x0 char} 6 03/24/2018真正07:00:01”“{0 x0 char} 703/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,…,的家．

例子:opts = setvaropts(opts，'Weight'，'FillValue'，0)设置FillValue对于变量重量来0．

所有变量类型的通用选项

全部折叠

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

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

数据类型	描述
`“字符”` `“字符串”`	文本。
`“单一”` `“双”`	单精度或双精度浮点数。
`“int8”`，`“int16”`，`“int32”`，`“int64”` `“uint8”`，`“uint16”`，`“uint32”`，`“uint64”`	有符号或无符号整数，存储为8位、16位、32位或64位整数。整型数据类型不定义与浮点数对应的值`南`，`负`,`+正`．因此，当您将浮点数据作为整数数组导入时，导入函数将转换未定义的浮点数: `南`转换为`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实例设置为当前日期和时间。例子:`[1998 12 1]`将缺失的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”`- - - - - -过程来管理双引号
`“删除”`|`“保持”`|`“错误”`

过程来管理数据中的双引号，该数据指定为本表中的值之一。

引用规则过程

引用规则	过程
`“删除”`	如果双引号(`＂`)环绕字符，然后导入函数删除开头双引号和下一个出现的双引号，这将被解释为结束双引号。例子:`“500”`导入为`500`．如果有两组双引号(`＂＂`)环绕字符，然后导入函数删除前两次出现的字符。例子:`”“abc”“`导入为`美国广播公司"`．如果字符周围有一对开闭引号，后面跟着一个单独的未配对双引号，则导入函数忽略单独的未配对双引号。例子:`“abc”“`导入为`美国广播公司(abc)”`．
`“保持”`	保留所有的引号。
`“错误”`	在转换以双引号开头的数据时报告错误(`＂`)．如果字段不应该被引用，则使用此设置。

“删除”

如果双引号(＂)环绕字符，然后导入函数删除开头双引号和下一个出现的双引号，这将被解释为结束双引号。

例子:“500”导入为500．

如果有两组双引号(＂＂)环绕字符，然后导入函数删除前两次出现的字符。

例子:”“abc”“导入为美国广播公司"．

如果字符周围有一对开闭引号，后面跟着一个单独的未配对双引号，则导入函数忽略单独的未配对双引号。

例子:“abc”“导入为美国广播公司(abc)”．

“保持”

保留所有的引号。

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

例子:如果“QuoteRule”设置为“删除”，则导入函数进行导入“abc“def”作为六边形abcdef”．

数据类型:字符|字符串

`“EmptyFieldRule”`- - - - - -过程来管理空字段
`“失踪”`(默认)|`“错误”`|`“汽车”`

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

“失踪”—请按照MissingRule财产
“错误”—请按照ImportErrorRule财产

“汽车”—根据变量的数据类型，设置为空值

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

例子:opts = setvaropts(opts，'RestorationTime'，'EmptyFieldRule'，'auto');

数据类型:字符|字符串

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

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

例子:opts = setvaropts(opts，'Var1'，' prefix '，'$')设置前缀变量的选项Var1．如果Var1包含值为“500美元”,然后readtable读起来是“500”．

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

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

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

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

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

文本变量选项

全部折叠

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

过程，用于在导入作为表中的值之一指定的文本数据时管理前导和尾随空白。

空白规则	过程
`“修剪”`	删除文本的前导空格或尾随空格。室内白色空间不受影响。例子:`“世界时间”`导入为`“世界时间”`
`“trimleading”`	只删除前导空白。例子:`“世界时间”`导入为`“世界时间”`
`“trimtrailing”`	只移除尾随的空格。例子:`“世界时间”`导入为`“世界时间”`
`“保存”`	保留空白。例子:`“世界时间”`导入为`“世界时间”`

数据类型:字符|字符串

数值变量选项

全部折叠

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

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

例子:如果varOpts。ExponentCharacter = 'a'，然后导入函数导入文本“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。TRUE符号= {'t'，'TRUE'}，然后导入函数导入包含t或真正的作为逻辑值真正的．

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

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

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

例子:如果varOpts。FALSE符号= {'f'，'FALSE'}，然后导入函数导入包含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日`
`'MMMM d, yyyy'`	`4月19日`
`'eeee, MMMM d, yyyy h:mm a'`	`2014年4月19日星期六晚上9:41`
`'MMMM 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”`- - - - - -用于解释日期的区域
特征向量|字符串标量

区域设置用于解释指定为字符向量或字符串标量的日期。的DatetimeLocaleValue决定导入函数如何解释表示日期和时间的文本。

设置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'将日期时间区域设置为德语。

请注意

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

数据类型:字符|字符串

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

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

时区使用以下任意一个值:

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

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

的价值`时区`	UTC抵消	UTC夏令时偏移量
`“非洲/约翰内斯堡”`	+ 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

没有指定的日期时间数组时区不能与具有时区属性设置为特定的时区。

数据类型:字符|字符串

分类变量选项

全部折叠

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

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

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

例子:varOpts。类别= {'BareLand'，'Forest'，'Water'，'Roads'，'Buildings'};

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

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

`“顺序”`- - - - - -数学排序指示器
`假`(默认)|`真正的`|`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”`- - - - - -表示字段分隔的字符
`：`(默认)|特征向量|字符串标量