readvars

从文件中读取变量

页面上倒塌

语法

[var1，var2，...，varn] = readvars（文件名）

[var1，var2，...，varn] = readvars（文件名，选择）

[var1，var2，...，varn] = readvars（＿＿＿、名称、值)

描述

例子

[var1，var2，...，varn] = readvars（文件名）通过从文件中读取面向列的数据来创建变量。如果该文件包含N然后是数据列readvars返回N变量var1，var2，...，varn．

readvars从文件扩展名确定文件格式:

. txt，.dat，或者. csv用于分隔文本文件
xls，.xlsb，.xlsm，.xlsx，.xltm，.xltx，或者.ods.电子表格文件

例子

[var1，var2，...，varn] = readvars（文件名，选择）此外，还使用了导入选项选择．

例子

[var1，var2，...，varn] = readvars（＿＿＿，名称,值）使用一个或多个名称-值对参数指定的附加选项从文件中创建变量。在指定名称-值对之前，使用前面语法中的任何输入参数。

要为数据设置特定的导入选项，您可以使用选择对象，也可以指定名称-值对。如果您指定名称-值对选择,然后readvars金宝app仅支持以下名称-值对:

文本文件,DateLocale，编码
电子表格文件,床单，UseExcel

例子

全部折叠

从文本文件读取变量

打开直播脚本

从文本文件中的表格数据中导入列作为单独的变量。首先，预览文本文件的内容outages.csv然后读取列。

将数据预览到outages.csv．该文件已经6变量。

opts = detectimportoptions（'outages.csv'）;预览('outages.csv'，选择）

ans =8×6表地区OutageTime损失客户恢复时间___________________________________________________________________________________________________________________________________________________________________02-07 16:50 {'冬季风暴'} {'southeast'} 2003-01-23 00:49 530.14 2.1204E + 05 Nat {'冬季风暴'} {'Southeast'} 2003-02-07 21:15 289.4 1.4294E + 05 2003-02-17 08:14 {冬季风暴'} {'west'} 2004-04-06 05:44 434.81 3.4037E + 05 2004-04-06 06:10 {'midwest'} {'midwest'} 2002-03-16 06:18 186.44 2.1275E +05 2002-03-18 23:23 {'secort Storm'} {'West'} 2003-06-18 02:49 0 0 2003-06-18 10:54 {'攻击'} {'West'} 2004-06-20 14:39 231.29南2004-06-20 19:16 {'设备故障'} {'West'} 2002-06-06 19:28 311.86 NaN 2002-06-07 00:51 {'设备故障'}

在工作区中将前三列作为单独的变量导入。

(地区、OutageTime损失)= readvars ('outages.csv'）;谁地区过剩损失

名称大小字节类属性丢失1468x1 11744 double OutageTime 1468x1 23520 datetime区域1468x1 174988 cell

从电子表格文件读取变量

打开直播脚本

从电子表格文件导入列作为工作区中的单独变量。首先，预览文本文件的内容outages.csv然后读取列作为单独的变量。

将数据预览到patients.xls．该文件已经10.变量。

opts = detectimportoptions（“patients.xls”）;预览(“patients.xls”，选择）

ans =8×10的表LastName性别年龄身高体重吸烟者收缩压舒张压SelfAssessedHealthStatus位置  ____________ __________ ___ _____________________________ ______ ______ ______ ________ _________ ________________________ {' 史密斯的38}{‘男性’}{县综合医院的}71 176真正的124 93{‘优秀’}{“约翰逊”}{‘男性’}69年43 {VA医院的}163假109 77 {'Fair'} {'Williams'} {'Female'} 38 {'St。64 131假125 83{“好”}{“琼斯”}{“女”}40{“VA医院”}67 133假117 75{“公平”}{“布朗”}{“女”}49{“县总医院”}64 119假122 80{“好”}{“戴维斯”}{“女”}46{“圣。“玛丽的医疗中心”}68 142假121 70{“好”}{“米勒”}{“女性”}33{“VA医院”}64 142真130 88{“好”}{“威尔逊”}{“男性”}40{“VA医院”}68 180假115 82{“好”}

在工作区中将前三列作为单独的变量导入。

(姓,性别,年龄)= readvars (“patients.xls”）;谁姓性别年龄

Name Size Bytes Class Attributes Age 100x1 800 double Gender 100x1 11412 cell LastName 100x1 11616 cell

使用导入选项从指定表格和范围的读取变量

打开直播脚本

预览电子表格文件中的数据，并从指定的工作表和范围中导入数据列作为单独的变量。

电子表格文件airlinesmall_subset.xlsx在多个工作表中包含1996年至2008年间的数据。每个工作表都有给定年份的数据。预览文件中的数据airlinesmall_subset.xlsx．的预览函数默认显示来自第一个工作表的数据。

opts = detectimportoptions（'airlinesmall_subset.xlsx'）;预览('airlinesmall_subset.xlsx'，选择）

ans =表8×29Year Month DayofMonth DayOfWeek DepTime CRSDepTime ArrTime CRSArrTime uniquercarrier FlightNum TailNum ActualElapsedTime CRSElapsedTime AirTime ArrDelay DepDelay Origin Dest Distance TaxiIn TaxiOut Cancelled CancellationCode used CarrierDelay WeatherDelay SDelay SecurityDelay LateAircraftDelay _________ __________ _________ _______ _________________ __________ _____________ _________ __________ _________________ ______________ _______ ________ ________ _______ _______ ________ ______ _______ _________ ________________ ________ ____________ ____________ __________ _____________ _________________ 18 4 1996 2117 2120 2305 2259 415{“惠普”}{‘N637AW} 108 99 85 6 3{'因为'}{‘PHX} 551 518 0 {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} 1996 1 12 5 1252 1245 1511 1500 610{“惠普”}{‘N905AW} 79 75 58 11 7{“宽松”}{‘PHX} 370 3 18 0 {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} 1996 1 16 2 1441 1445 1708 1721 211{“惠普”}{‘N165AW} 87 96 74 -13 4{‘汽车’}{‘PHX} 601 4 9 0 {0 x0 char} {0 x0char} {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} 1996 1 1 1 2258 2300 2336 2335 1245{“惠普”}{‘N183AW} 38 35 20 1 2{“摘要”}{‘PHX} 110 6 12 0 {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} 1996 1 4 4 1814 683 1814 1901 1910{‘我们’}{‘N963VJ} 47 56 34 9 0{的DTW}{‘坑’}201 6 7 0 {0 x0 char} {0 x0 char} {0 x0 char} {0 x0char} {0 x0 char} {0 x0 char} 1996 1 31 3 1822 757 1820 1934 1925{‘我们’}{‘N912VJ} 72 65 52 9 2{‘PHL}{‘坑’}267 6 14 0 {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} 1996 1 18 4 729 1564 730 841 843{‘我们’}{‘N941VJ} 72 73 58 2 1 {DCA的}{PVD的}357 3 11 0 {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char}1996 1 26 5 1704 1705 1829 1839 {'NW'} 1538 {'N960N' } 85 94 69 -10 -1 {'DTW'} {'RIC'} 456 3 13 0 {0x0 char} 0 {0x0 char} {0x0 char} {0x0 char} {0x0 char} {0x0 char}

配置值选择对象导入10.列的行5和6的工作表名称“2007”．

选择。床单=“2007”;选择。SelectedVariableNames = [5 6];选择。DataRange =“二”;[DepTime, CRSDepTime] = readvars ('airlinesmall_subset.xlsx'、选择);

显示变量。

[DepTime, CRSDepTime]

ans =10×2711 710 652 655 1116 1120 825 825 1411 1400 1935 1935 2005 2005 1525 1525 1133 1105 922 925

从指定工作表和范围读取变量

打开直播脚本

从电子表格文件中预览数据并将列作为单独的变量从指定的表格和范围导入。

opts = detectimportoptions（'airlinesmall_subset.xlsx'）;预览('airlinesmall_subset.xlsx'，选择）

ans =表8×29Year Month DayofMonth DayOfWeek DepTime CRSDepTime ArrTime CRSArrTime uniquercarrier FlightNum TailNum ActualElapsedTime CRSElapsedTime AirTime ArrDelay DepDelay Origin Dest Distance TaxiIn TaxiOut Cancelled CancellationCode used CarrierDelay WeatherDelay SDelay SecurityDelay LateAircraftDelay _________ __________ _________ _______ _________________ __________ _____________ _________ __________ _________________ ______________ _______ ________ ________ _______ _______ ________ ______ _______ _________ ________________ ________ ____________ ____________ __________ _____________ _________________ 18 4 1996 2117 2120 2305 2259 415{“惠普”}{‘N637AW} 108 99 85 6 3{'因为'}{‘PHX} 551 518 0 {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} 1996 1 12 5 1252 1245 1511 1500 610{“惠普”}{‘N905AW} 79 75 58 11 7{“宽松”}{‘PHX} 370 3 18 0 {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} 1996 1 16 2 1441 1445 1708 1721 211{“惠普”}{‘N165AW} 87 96 74 -13 4{‘汽车’}{‘PHX} 601 4 9 0 {0 x0 char} {0 x0char} {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} 1996 1 1 1 2258 2300 2336 2335 1245{“惠普”}{‘N183AW} 38 35 20 1 2{“摘要”}{‘PHX} 110 6 12 0 {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} 1996 1 4 4 1814 683 1814 1901 1910{‘我们’}{‘N963VJ} 47 56 34 9 0{的DTW}{‘坑’}201 6 7 0 {0 x0 char} {0 x0 char} {0 x0 char} {0 x0char} {0 x0 char} {0 x0 char} 1996 1 31 3 1822 757 1820 1934 1925{‘我们’}{‘N912VJ} 72 65 52 9 2{‘PHL}{‘坑’}267 6 14 0 {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} 1996 1 18 4 729 1564 730 841 843{‘我们’}{‘N941VJ} 72 73 58 2 1 {DCA的}{PVD的}357 3 11 0 {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char} {0 x0 char}1996 1 26 5 1704 1705 1829 1839 {'NW'} 1538 {'N960N' } 85 94 69 -10 -1 {'DTW'} {'RIC'} 456 3 13 0 {0x0 char} 0 {0x0 char} {0x0 char} {0x0 char} {0x0 char} {0x0 char}

进口10.从工作表中命名的前三个变量的行“2007”．

[Year, Month, DayOfMonth] = readvars('airlinesmall_subset.xlsx'，“表”，“2007”，“范围”，“A2: C11”）;谁一年月DayOfMonth

名称大小字节类属性Dayofmonth 10x1 80双月10x1 80双年10x1 80双倍

disp((年月DayOfMonth))

2007 12 2007 13 2007 1 4 2007 1 5 2007 1 7 2007 1 8 2007 1 9 2007 1 11 2007 1 12 2007 1 13

输入参数

全部折叠

`文件名`- - - - - -要读取的文件名称
特征向量|字符串标量

要读取的文件名称，指定为字符向量或字符串标量。

根据文件的位置，文件名可以采取其中一种形式。

位置

形式

当前文件夹或MATLAB上的文件夹^®路径

中指定文件的名称文件名．

例子:“myFile.txt”

文件夹中的文件

如果文件不在当前文件夹或MATLAB路径上的某个文件夹中，则在文件名．

例子:'c：\ myfolder \ myfile.xlsx'

例子:“dataDir \ myFile.txt”

互联网网址

如果文件被指定为internet统一资源定位符(URL)，则文件名必须包含协议类型“http://”或者“https://”．

例子:“http://hostname/path_to_file/my_data.csv”

远程位置

如果文件存储在远程位置，那么文件名必须包含表单指定的文件的完整路径:

scheme_name：//path_to_file/my_file.ext

根据偏远的位置，scheme_name可以是此表中的值之一。

远程位置	`scheme_name`
Amazon S3™	`S3.`
Windows Azure^®Blob Storage.	`wasb`，`草原`
HDFS™	`hdfs`

有关更多信息，请参见使用远程数据．

例子:s3: / / bucketname / path_to_file / my_file.csv '

如果文件名包含文件扩展名，然后导入函数根据扩展名确定文件格式。否则，必须指定“文件类型”名称-值对参数表示文件的类型。
在Windows上^®与微软系统^®Excel^®导入功能读取您的Excel版本所识别的任何Excel电子表格文件格式。
如果您的系统没有Windows的Excel，或者您正在使用MATLAB在线™时，导入函数使用UseExcel属性设置为假，只读.xls，.xlsx，.xlsm，.xltx和.xltm文件。
对于分隔文本文件，导入函数将文件中的空字段转换为南(用于数值变量)或空字符向量(用于文本变量)。文本文件中的所有行必须具有相同数量的分隔符。导入函数忽略文件中无关紧要的空白。

数据类型:字符|字符串

`选择`- - - - - -文件导入选项
`SpreadsheetImportOptions`|`DelimitedtextImportOptions`|`多个沃特莫特选项`|`XMLImportOptions`

文件导入选项，指定为SpreadsheetImportOptions，DelimitedTextImportOptions，多个沃特莫特选项，或者XMLImportOptions对象创建的detectImportOptions函数。的选择对象包含控制数据导入过程的属性。有关每个对象属性的更多信息，请参见相应的对象页。

类型的文件	输出
电子表格文件	`SpreadsheetImportOptions`对象(仅对`床单`，`DataRange`，和`VariableNames`特性）
文本文件	`DelimitedTextImportOptions`对象
宽度固定的文本文件	`多个沃特莫特选项`对象
XML文件	`XMLImportOptions`对象

名称-值对的观点

指定可选的逗号分隔对名称,值参数。的名字参数名和价值是相应的价值。的名字必须出现在引号内。您可以按如下顺序指定几个名称和值对参数Name1, Value1,…,的家．

例子:“NumHeaderLines”,5表示在表格数据之前的前五条线是标题线。

文本和电子表格文件

全部折叠

`“文件类型”`- - - - - -文件类型
`'文本'`|`“表格”`

文件类型，指定为逗号分隔的对，由“文件类型”和'文本'或者“表格”．

指定“文件类型”参数时的名称-值对参数文件名不包括文件扩展名或扩展名不是以下之一:

. txt，.dat，或者. csv用于分隔文本文件
xls，.xlsb，.xlsm，.xlsx，.xltm，.xltx，或者.ods.电子表格文件

例子:“文件类型”、“文本”

数据类型:字符|字符串

`“NumHeaderLines”`- - - - - -标题行数
正整数

文件中的标题行数，指定为逗号分隔的对，由“NumHeaderLines”一个正整数。如果未指定，导入函数将自动检测文件的标题行数。

例子:“NumHeaderLines”7

数据类型:单|双

`“ExpectedNumVariables”`- - - - - -期望变量数
正整数

期望的变量数，指定为逗号分隔的对，由“ExpectedNumVariables”一个正整数。如果未指定，导入函数将自动检测变量的个数。

数据类型:单|双

`“范围”`- - - - - -要读取的部分数据
特征向量|字符串标量|数值向量

要从文本或电子表格文件中读取的部分数据，指定为逗号分隔的对，由“范围”和其中一个表单中的字符向量，字符串标量或数字矢量。

指定的方法范围 描述

指定的方法`范围`	描述
起始牢房 `“细胞”`或者`[行col]`	将数据的起始小区指定为字符向量或字符串标量或两个元素数字向量。使用Excel包含列字母和行号的字符向量或字符串标量`A1`符号。例如,`A5`单元格的标识符是否在列的交点`一个`和行`5`．两元素数值矢量的形式`[行col]`指示起始行和列。使用起始单元格，导入函数通过从起始单元格开始导入，到最后一个空行或页脚范围结束，自动检测数据的范围。例子:`的A5`或者`[5 1]`
矩形范围 `'Corner1：Corner2'`或者`[R1 C1 R2 C2]`	使用下列形式之一的矩形范围指定要读取的确切范围。 `'Corner1：Corner2'`-指定使用的范围`Corner1`和`Corner2`哪两个相对的角定义了Excel中要读取的区域`A1`符号。例如,`'C2：N15'`． `[R1 C1 R2 C2]`—使用包含起始行、起始列、结束行和结束列的4个元素的数字向量指定范围。例如,`[2 3 15 13]`．导入函数只读取包含在指定范围内的数据。指定范围内的任何空字段都将作为缺少的单元格导入。
行范围或列范围 `“第一行:Row2”`或者`“Column1: Column2”`	通过使用Excel行号标识开始行和结束行来指定范围。使用指定的行范围，导入函数通过从第一个非空列读取到数据的末尾来自动检测列的范围，并为每个列创建一个变量。例子:`“5:500”` 或者，通过使用Excel列字母或数字标识开始和结束列来指定范围。使用指定的列范围，导入函数通过从第一个非空行读取到数据或页脚范围的末尾来自动检测行范围。指定范围中的列数必须与指定的数字匹配`预示.`财产。例子:`'A：K'`
起始行号 `n`	使用正标量行索引指定包含数据的第一行。使用指定的行索引，导入函数通过从指定的第一行读取到数据或页脚范围的末尾来自动检测数据的范围。例子:`5`
Excel的命名范围 `'namedrange'`	在Excel中，您可以创建名称来标识电子表格中的范围。例如，您可以选择电子表格的一个矩形部分并调用它`“myTable”`．如果在电子表格中存在此类命名范围，则导入功能可以使用其名称读取该范围。例子:`“范围”、“myTable”`
不明或空 `＇＇`	如果未指定，导入功能将自动检测使用的范围。例子:`“范围”,“` 笔记：使用范围指电子表格中实际包含数据的矩形部分。导入函数通过修剪不包含数据的任何开头和结尾行和列，自动检测使用的范围。仅为空白的文本被视为数据，并在使用范围内捕获。

起始牢房

“细胞”或者[行col]

将数据的起始小区指定为字符向量或字符串标量或两个元素数字向量。

使用Excel包含列字母和行号的字符向量或字符串标量A1符号。例如,A5单元格的标识符是否在列的交点一个和行5．
两元素数值矢量的形式[行col]指示起始行和列。

使用起始单元格，导入函数通过从起始单元格开始导入，到最后一个空行或页脚范围结束，自动检测数据的范围。

例子:的A5或者[5 1]

矩形范围

'Corner1：Corner2'或者[R1 C1 R2 C2]

使用下列形式之一的矩形范围指定要读取的确切范围。

'Corner1：Corner2'-指定使用的范围Corner1和Corner2哪两个相对的角定义了Excel中要读取的区域A1符号。例如,'C2：N15'．
[R1 C1 R2 C2]—使用包含起始行、起始列、结束行和结束列的4个元素的数字向量指定范围。例如,[2 3 15 13]．

导入函数只读取包含在指定范围内的数据。指定范围内的任何空字段都将作为缺少的单元格导入。

行范围或列范围

“第一行:Row2”或者“Column1: Column2”

通过使用Excel行号标识开始行和结束行来指定范围。

使用指定的行范围，导入函数通过从第一个非空列读取到数据的末尾来自动检测列的范围，并为每个列创建一个变量。

例子:“5:500”

或者，通过使用Excel列字母或数字标识开始和结束列来指定范围。

使用指定的列范围，导入函数通过从第一个非空行读取到数据或页脚范围的末尾来自动检测行范围。

指定范围中的列数必须与指定的数字匹配预示.财产。

例子:'A：K'

起始行号

n

使用正标量行索引指定包含数据的第一行。

使用指定的行索引，导入函数通过从指定的第一行读取到数据或页脚范围的末尾来自动检测数据的范围。

例子:5

Excel的命名范围

'namedrange'

在Excel中，您可以创建名称来标识电子表格中的范围。例如，您可以选择电子表格的一个矩形部分并调用它“myTable”．如果在电子表格中存在此类命名范围，则导入功能可以使用其名称读取该范围。

例子:“范围”、“myTable”

不明或空

＇＇

如果未指定，导入功能将自动检测使用的范围。

例子:“范围”,“

笔记：使用范围指电子表格中实际包含数据的矩形部分。导入函数通过修剪不包含数据的任何开头和结尾行和列，自动检测使用的范围。仅为空白的文本被视为数据，并在使用范围内捕获。

数据类型:字符|字符串|双

`“TextType”`- - - - - -用于导入文本数据的类型
`“字符”`(默认)|`“字符串”`

类型，指定为逗号分隔的对，由“TextType”,要么“字符”或者“字符串”．

“字符”- 将文本数据导入MATLAB作为字符向量。
“字符串”- 将文本数据导入MATLAB作为字符串数组。

例子:“TextType”、“生物炭”

`“DatetimeType”`- - - - - -输入导入日期和时间数据
`“datetime”`(默认)|`'文本'`|`'ExceldateNum'`(电子表格文件)

用于导入日期和时间数据的类型，指定为逗号分隔的对，由“DatetimeType”其中一个值是:“datetime”，'文本'，或者'ExceldateNum'．的值'ExceldateNum'只适用于电子表格文件，对文本文件无效。

价值导入日期和时间数据的类型

价值	导入日期和时间数据的类型
`“datetime”`	MATLAB`约会时间`数据类型有关更多信息，请参见`约会时间`．
`'文本'`	如果`“DatetimeType”`被指定为`'文本'`，则导入的日期和时间数据的类型取决于在`“TextType”`参数: 如果`“TextType”`被设置为`“字符”`，然后导入函数将日期作为字符向量的单元格数组返回。如果`“TextType”`被设置为`“字符串”`，然后导入函数将日期返回为字符串数组。
`'ExceldateNum'`	Excel序列号序列号是一个等于从给定参考日期算起的天数的单一数字。Excel序列号使用的参考日期与MATLAB序列号不同。有关Excel日期的更多信息，请参见`https://金宝appsupport.microsoft.com/en-us/kb/214330`．

“datetime”

MATLAB约会时间数据类型

有关更多信息，请参见约会时间．

'文本'

如果“DatetimeType”被指定为'文本'，则导入的日期和时间数据的类型取决于在“TextType”参数:

如果“TextType”被设置为“字符”，然后导入函数将日期作为字符向量的单元格数组返回。
如果“TextType”被设置为“字符串”，然后导入函数将日期返回为字符串数组。

'ExceldateNum'

Excel序列号

序列号是一个等于从给定参考日期算起的天数的单一数字。Excel序列号使用的参考日期与MATLAB序列号不同。有关Excel日期的更多信息，请参见https://金宝appsupport.microsoft.com/en-us/kb/214330．

数据类型:字符|字符串

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

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

例子:TreatAsMissing,{“NA”,“TBD”}指示导入功能治疗任何发生NA.或者TBD作为一个缺失的字段。

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

文本文件只

全部折叠

`“分隔符”`- - - - - -字段分隔符字符
特征向量|字符串标量|字符向量的单元数组|字符串数组

带分隔符的文本文件中的字段分隔符，指定为字符向量、字符串标量、字符向量的单元格数组或字符串数组。

例子:'delimiter'，'|'

例子:“分隔符 ',{';','*'}

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

`“空格”`- - - - - -以白色空间对待的人物
特征向量|字符串标量

要作为空格处理的字符，指定为包含一个或多个字符的字符向量或字符串标量。

例子:“空白”、“_”

例子:“空白”、“? !”

`“LineEnding”`- - - - - -行尾字符
`{' \ n ', ' \ r ', ' \ r \ n '}`(默认)|特征向量|字符串标量|字符向量的单元数组|字符串数组

行结束字符，指定为字符向量、字符串标量、字符向量的单元数组或字符串数组。

例子:' LineEnding ', ' \ n '

例子:“LineEnding”、“\ r \ n”

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

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

`“CommentStyle”`- - - - - -风格的评论
特征向量|字符串标量|字符向量的单元数组|字符串数组

注释的样式，指定为字符向量、字符串标量、字符向量的单元数组或字符串数组。

例如，要忽略同一行上百分号后面的文本，请指定CommentStyle.作为“%”．

例子:CommentStyle,{“/ *”}

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

`“编码”`- - - - - -字符编码方案
`“utf - 8”`|`“iso - 8859 - 1”`|`“windows - 1251”`|`'Windows-1252'`|......

与文件相关联的字符编码方案，由逗号分隔的对组成“编码”和“系统”或编码方案名称的标准字符。当您没有指定任何编码时，readvars函数使用自动character set检测来确定读取文件时的编码。

如果您指定“编码”除导入选项外，然后readvars函数使用指定的值“编码”，覆盖导入选项中定义的编码。

例子:“编码”,“utf - 8”使用UTF-8作为编码。

例子:'编码'，'system'使用系统默认编码。

数据类型:字符|字符串

`'durationtype'`- - - - - -持续时间数据的输出数据类型
`“持续时间”`(默认)|`'文本'`

从文本文件输出数据类型的持续时间数据，指定为逗号分隔对'durationtype',要么“持续时间”或者'文本'．

价值导入持续时间数据的类型

价值	导入持续时间数据的类型
`“持续时间”`	MATLAB`持续时间`数据类型有关更多信息，请参见`持续时间`．
`'文本'`	如果`'durationtype'`被指定为`'文本'`，然后导入持续时间数据的类型取决于指定的值`“TextType”`参数: 如果`“TextType”`被设置为`“字符”`，然后导入函数将持续时间数据作为字符向量的单元格数组返回。如果`“TextType”`被设置为`“字符串”`，然后导入函数将持续时间数据作为字符串数组返回。

“持续时间”

MATLAB持续时间数据类型

有关更多信息，请参见持续时间．

'文本'

如果'durationtype'被指定为'文本'，然后导入持续时间数据的类型取决于指定的值“TextType”参数:

如果“TextType”被设置为“字符”，然后导入函数将持续时间数据作为字符向量的单元格数组返回。
如果“TextType”被设置为“字符串”，然后导入函数将持续时间数据作为字符串数组返回。

数据类型:字符|字符串

`“DateLocale”`- - - - - -日期阅读地点
特征向量|字符串标量

读取日期的区域设置，指定为逗号分隔的对，由“DateLocale”一个字符向量或者字符串标量xx＿YY,地点:

YY是一个大写ISO 3166-1 Alpha-2代码，指示一个国家。
xx是一个小写的ISO 639-1两字母代码，表示一种语言。

有关区域设置的常见值列表，请参阅语言环境名称值对参数约会时间函数。

当使用% D读取文本的格式说明符约会时间值，使用DateLocale指定导入函数应该解释月份和日常名称和缩写的语言环境。

如果您指定DateLocale除了选择导入选项，然后导入函数使用指定的值DateLocale参数，重写在导入选项中定义的区域设置。

例子:'datelocale'，'ja_jp'

`“DecimalSeparator”`- - - - - -表示小数分隔符的字符
特征向量|字符串标量

在数字变量中指示小数分隔符的字符，指定为字符向量或字符串标量。控件中指定的字符将被导入函数使用DecimalSeparator名称-值对，用于区分数字的整数部分和小数部分。

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

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

数据类型:字符|字符串

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

表示数字变量中的千位分组的字符，指定为字符向量或字符串标量。成千上万的分组字符作为视觉分隔符，在每三个位置值分组数字。控件中指定的字符将被导入函数使用ThousandsSeparator名称-值对来解释被导入的数字。

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

数据类型:字符|字符串

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

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

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

数据类型:逻辑

`“ConsecutiveDelimitersRule”`- - - - - -处理连续分隔符的过程
`“分裂”`|`“加入”`|`“错误”`

过程来处理分隔文本文件中的连续分隔符，该分隔符指定为该表中的一个值。

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

数据类型:字符|字符串

`“LeadingDelimitersRule”`- - - - - -过程来管理开头分隔符
`'保持'`|`“忽略”`|`“错误”`

过程来管理带分隔符的文本文件中的开头分隔符，该文件指定为该表中的一个值。

领先的分隔符规则	行为
`'保持'`	分隔符。
`“忽略”`	忽略了分隔符。
`“错误”`	返回一个错误并中止导入操作。

`“TrailingDelimitersRule”`- - - - - -管理尾随分隔符的过程
`'保持'`|`“忽略”`|`“错误”`

过程来管理带分隔符的文本文件中的尾随分隔符，将其指定为该表中的一个值。

领先的分隔符规则	行为
`'保持'`	分隔符。
`“忽略”`	忽略了分隔符。
`“错误”`	返回一个错误并中止导入操作。

仅限电子表格文件

全部折叠

`“表”`- - - - - -可供阅读的页
`＇＇`空字符数组(默认)|特征向量|字符串标量|积极的标量整数

要从中读取的工作表，指定为空字符数组、包含工作表名称的字符向量或字符串标量，或表示工作表索引的正标量整数。对象指定的值床单属性，则导入函数的行为如表中所述。

规范	行为
`＇＇`(默认)	从第一张作为导入数据。
的名字	从匹配的工作表名称导入数据，而不考虑电子表格文件中工作表的顺序。
整数	无论电子表格文件中的工作表名称如何导入由整数的位置的页面导入数据。

数据类型:字符|字符串|单|双

`“UseExcel”`- - - - - -启动Microsoft Excel for Windows实例的标志
`假`(默认)|`真的`

的实例启动微软Excel.在Windows中读取电子表格数据时，指定为逗号分隔的对，由“UseExcel”,要么真的，或者假．

你可以设置“UseExcel”参数到其中一个值：

真的- 读取文件时，导入函数启动Microsoft Excel的实例。
假—导入功能在读取文件时不会启动Microsoft Excel实例。在这种模式下操作时，导入函数的功能在支持文件格式和交互特性(如公式和宏)方面有所不同。金宝app

UseExcel	`真的`	`假`
金宝app支持文件格式	`.xls，.xlsx，.xlsm，.xltx，.xltm，.xlsb，.ods`	`.xls， .xlsx， .xlsm， .xltx， .xltm`
金宝app支持交互式特性，如公式和宏	是的	不

在Windows平台上读取电子表格文件时，如果您想启动微软Excel.，然后设置“UseExcel”参数到真的．

另请参阅

readcell|readmatrix|readtable|readtimetable

介绍了R2019a

readvars

语法

描述

例子

从文本文件读取变量

从电子表格文件读取变量

使用导入选项从指定表格和范围的读取变量

从指定工作表和范围读取变量

输入参数

`文件名`- - - - - -要读取的文件名称
特征向量|字符串标量

`选择`- - - - - -文件导入选项
`SpreadsheetImportOptions`|`DelimitedtextImportOptions`|`多个沃特莫特选项`|`XMLImportOptions`

名称-值对的观点

`“文件类型”`- - - - - -文件类型
`'文本'`|`“表格”`

`“NumHeaderLines”`- - - - - -标题行数
正整数

`“ExpectedNumVariables”`- - - - - -期望变量数
正整数

`“范围”`- - - - - -要读取的部分数据
特征向量|字符串标量|数值向量

`“TextType”`- - - - - -用于导入文本数据的类型
`“字符”`(默认)|`“字符串”`

`“DatetimeType”`- - - - - -输入导入日期和时间数据
`“datetime”`(默认)|`'文本'`|`'ExceldateNum'`(电子表格文件)

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

`“分隔符”`- - - - - -字段分隔符字符
特征向量|字符串标量|字符向量的单元数组|字符串数组

`“空格”`- - - - - -以白色空间对待的人物
特征向量|字符串标量

`“LineEnding”`- - - - - -行尾字符
`{' \ n ', ' \ r ', ' \ r \ n '}`(默认)|特征向量|字符串标量|字符向量的单元数组|字符串数组

`“CommentStyle”`- - - - - -风格的评论
特征向量|字符串标量|字符向量的单元数组|字符串数组

`“编码”`- - - - - -字符编码方案
`“utf - 8”`|`“iso - 8859 - 1”`|`“windows - 1251”`|`'Windows-1252'`|......

`'durationtype'`- - - - - -持续时间数据的输出数据类型
`“持续时间”`(默认)|`'文本'`

`“DateLocale”`- - - - - -日期阅读地点
特征向量|字符串标量

`“DecimalSeparator”`- - - - - -表示小数分隔符的字符
特征向量|字符串标量

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

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

`“ConsecutiveDelimitersRule”`- - - - - -处理连续分隔符的过程
`“分裂”`|`“加入”`|`“错误”`

`“LeadingDelimitersRule”`- - - - - -过程来管理开头分隔符
`'保持'`|`“忽略”`|`“错误”`

`“TrailingDelimitersRule”`- - - - - -管理尾随分隔符的过程
`'保持'`|`“忽略”`|`“错误”`

`“表”`- - - - - -可供阅读的页
`＇＇`空字符数组(默认)|特征向量|字符串标量|积极的标量整数

`“UseExcel”`- - - - - -启动Microsoft Excel for Windows实例的标志
`假`(默认)|`真的`

另请参阅

MATLAB的文档

金宝app

介绍MATLAB深度学习

readvars

语法

描述

例子

从文本文件读取变量

从电子表格文件读取变量

使用导入选项从指定表格和范围的读取变量

从指定工作表和范围读取变量

输入参数

文件名- - - - - -要读取的文件名称特征向量|字符串标量

选择- - - - - -文件导入选项SpreadsheetImportOptions|DelimitedtextImportOptions|多个沃特莫特选项|XMLImportOptions

名称-值对的观点

“文件类型”- - - - - -文件类型'文本'|“表格”

“NumHeaderLines”- - - - - -标题行数正整数

“ExpectedNumVariables”- - - - - -期望变量数正整数

“范围”- - - - - -要读取的部分数据特征向量|字符串标量|数值向量

“TextType”- - - - - -用于导入文本数据的类型“字符”(默认)|“字符串”

“DatetimeType”- - - - - -输入导入日期和时间数据“datetime”(默认)|'文本'|'ExceldateNum'(电子表格文件)

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

“分隔符”- - - - - -字段分隔符字符特征向量|字符串标量|字符向量的单元数组|字符串数组

“空格”- - - - - -以白色空间对待的人物特征向量|字符串标量

“LineEnding”- - - - - -行尾字符{' \ n ', ' \ r ', ' \ r \ n '}(默认)|特征向量|字符串标量|字符向量的单元数组|字符串数组

“CommentStyle”- - - - - -风格的评论特征向量|字符串标量|字符向量的单元数组|字符串数组

“编码”- - - - - -字符编码方案“utf - 8”|“iso - 8859 - 1”|“windows - 1251”|'Windows-1252'|......

'durationtype'- - - - - -持续时间数据的输出数据类型“持续时间”(默认)|'文本'

“DateLocale”- - - - - -日期阅读地点特征向量|字符串标量

“DecimalSeparator”- - - - - -表示小数分隔符的字符特征向量|字符串标量

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

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

“ConsecutiveDelimitersRule”- - - - - -处理连续分隔符的过程“分裂”|“加入”|“错误”

“LeadingDelimitersRule”- - - - - -过程来管理开头分隔符'保持'|“忽略”|“错误”

“TrailingDelimitersRule”- - - - - -管理尾随分隔符的过程'保持'|“忽略”|“错误”

“表”- - - - - -可供阅读的页＇＇空字符数组(默认)|特征向量|字符串标量|积极的标量整数

“UseExcel”- - - - - -启动Microsoft Excel for Windows实例的标志假(默认)|真的

另请参阅

MATLAB的文档

金宝app

介绍MATLAB深度学习

`文件名`- - - - - -要读取的文件名称
特征向量|字符串标量

`选择`- - - - - -文件导入选项
`SpreadsheetImportOptions`|`DelimitedtextImportOptions`|`多个沃特莫特选项`|`XMLImportOptions`

`“文件类型”`- - - - - -文件类型
`'文本'`|`“表格”`

`“NumHeaderLines”`- - - - - -标题行数
正整数

`“ExpectedNumVariables”`- - - - - -期望变量数
正整数

`“范围”`- - - - - -要读取的部分数据
特征向量|字符串标量|数值向量

`“TextType”`- - - - - -用于导入文本数据的类型
`“字符”`(默认)|`“字符串”`

`“DatetimeType”`- - - - - -输入导入日期和时间数据
`“datetime”`(默认)|`'文本'`|`'ExceldateNum'`(电子表格文件)

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

`“分隔符”`- - - - - -字段分隔符字符
特征向量|字符串标量|字符向量的单元数组|字符串数组

`“空格”`- - - - - -以白色空间对待的人物
特征向量|字符串标量

`“LineEnding”`- - - - - -行尾字符
`{' \ n ', ' \ r ', ' \ r \ n '}`(默认)|特征向量|字符串标量|字符向量的单元数组|字符串数组

`“CommentStyle”`- - - - - -风格的评论
特征向量|字符串标量|字符向量的单元数组|字符串数组

`“编码”`- - - - - -字符编码方案
`“utf - 8”`|`“iso - 8859 - 1”`|`“windows - 1251”`|`'Windows-1252'`|......

`'durationtype'`- - - - - -持续时间数据的输出数据类型
`“持续时间”`(默认)|`'文本'`

`“DateLocale”`- - - - - -日期阅读地点
特征向量|字符串标量

`“DecimalSeparator”`- - - - - -表示小数分隔符的字符
特征向量|字符串标量

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

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

`“ConsecutiveDelimitersRule”`- - - - - -处理连续分隔符的过程
`“分裂”`|`“加入”`|`“错误”`

`“LeadingDelimitersRule”`- - - - - -过程来管理开头分隔符
`'保持'`|`“忽略”`|`“错误”`

`“TrailingDelimitersRule”`- - - - - -管理尾随分隔符的过程
`'保持'`|`“忽略”`|`“错误”`

`“表”`- - - - - -可供阅读的页
`＇＇`空字符数组(默认)|特征向量|字符串标量|积极的标量整数

`“UseExcel”`- - - - - -启动Microsoft Excel for Windows实例的标志
`假`(默认)|`真的`