readtable

从文件创建表

描述

例子

T= readtable(文件名)通过从文件中读取的面向列的数据创建一个表。

readtable确定从文件扩展名的文件格式:

  • 。文本文件,.DAT, 要么. csv用于分隔的文本文件

  • xls,.xlsb,.XLSM,.xlsx,.xltm,.xltx, 要么.ods档案电子表格文件

readtable创建一个变量T为文件中的每一列,并且读取从该文件的第一行的变量名。默认情况下,创建的变量当整个列是数字,字符向量或单元阵列时在一列中的任何元素不是数字。

例子

T= readtable(文件名,选择)使用导入选项创建一个表选择

例子

T= readtable(___,名称,值)从文件中创建一个表,其中包含由一个或多个名称-值对参数指定的附加选项。例如,您可以指定是否readtable读取该文件作为变量名或作为数据的第一行。

若要设置数据的特定导入选项,可以使用选择对象,或者您可以指定名称 - 值对。当您在除指定名称 - 值对选择, 然后readtable万博1manbetx仅支持这些名称 - 值对:

  • 文本和电子表格参数 -ReadVariableNames,ReadRowNames

  • 纯文字参数 -DateLocale,编码

  • 电子表格只有参数-,UseExcel

例子

全部收缩

加载文件myCsvTable.dat并在文本编辑器中预览其内容。屏幕截图如下所示。注意,该文件包含逗号分隔的面向列的数据。

文件名= fullfile (matlabroot,'例子','MATLAB','myCsvTable.dat');

从逗号分隔的文本文件创建一个表。结果表T为文件中的每一列包含一个变量readtable将文件第一行中的条目视为变量名。

T = readtable(文件名)
T =5×6表LastName性别年龄身高体重看上去吸烟者_______ ______ ___长得一样{“史密斯”}{“M”} 38 71 176 1{“约翰逊”}{“M”} 43 69 163 0{威廉姆斯的}{' F '} 38 64 131 0{“琼斯”}{' F '} 40 67 133 0{“棕色”}{' F '} 49 64 119 0

加载文件mySpaceDelimTable.txt并在文本编辑器中预览其内容。屏幕截图如下所示。注意,该文件包含以空格分隔的、面向列的数据。

文件名= fullfile (matlabroot,'例子','MATLAB',“mySpaceDelimTable.txt”);

从一个不包含变量名作为列标题空间分隔的文本文件创建一个表。

T = readtable(文件名,“分隔符”,“”,'ReadVariableNames'假)
T =3×5表Var1 Var2 Var3 Var4 Var5 _____ _____ _____ _____ _____ {“M”} 45 45{“纽约”}{“真实”}{' F '} 41 32 {“CA”}{“假”}{“M”} 40 34{‘马’}{“假”}

T包含默认变量名。

加载文件myCsvTable.dat并在文本编辑器中预览其内容。屏幕截图如下所示。注意,该文件包含逗号分隔的面向列的数据。

文件名= fullfile (matlabroot,'例子','MATLAB','myCsvTable.dat');

从逗号分隔的文本文件创建一个表。将前两列作为字符向量导入,将第三列作为字符向量导入uint32后两列为双精度浮点数。将最后一列的条目作为字符向量导入。

T = readtable(文件名,“格式”,'%s%S%U%F%F%S')
T =5×6表LastName性别年龄身高体重看上去吸烟者_______ ______ ___长得一样{“史密斯”}{“M”} 38 71 176{' 1 '}{“约翰逊”}{“M”} 43 69 163{' 0 '}{威廉姆斯的}{' F '} 38 64 131{' 0 '}{“琼斯”}{' F '} 40 67 133{' 0 '}{“棕色”}{' F '} 49 64 119 {' 0 '}

转换说明符是%S对于字符向量的单元数组,%F对于%u对于uint32

从文件中读取德国日期,并将它们添加到表英语日期。

加载文件german_dates.txt并在文本编辑器中预览其内容。屏幕截图如下所示。注意,值的第一列包含德语日期,第二和第三列是数值。

文件名= fullfile (matlabroot,'例子','MATLAB',“german_dates.txt”);

使用以下命令读取示例文件readtable。转换标识符是%d日期和%F对于浮点值。指定使用的编码文件FileEncoding名称-值对的论点。属性指定日期的格式和区域设置DateLocale名称-值对的论点。

T = readtable(文件名,'ReadVariableNames'假的,“格式”,'%{dd MMMM yyyy}D %f %f',“FileEncoding”,'ISO-8859-15','DateLocale','de_DE' 对应)
T =3×3表VAR1 VAR2 VAR3 ________________ ____ _____ 2014年1月1日20.2 100.5 2014年2月1日21.6 102.7 2014年3月1日20.7 99.8

从电子表格中创建一个表,其中第一行包含变量名,第一列包含行名。

T = readtable('patients.xls',“ReadRowNames”,真正的);

显示前五个行和表的前四个变量。

T(1:5,1:4)
ans =5×4表性别年龄位置高度__________ ___ _____________________________ ______史密斯{‘男性’}38{县综合医院的}71年约翰逊43{‘男性’}{VA医院的}69年威廉姆斯{‘女性’}38{圣。玛丽医疗中心琼斯女子医院布朗布朗县总医院玛丽医疗中心琼斯女子医院布朗布朗县总医院

观看DimensionNames该表的属性。

T.Properties.DimensionNames
ans =1×2单元阵列{' LastName}{}“变量”

“姓”是电子表格第一行第一列中的名称。

使用电子表格中指定区域的数据创建表patients.xls。使用来自角之间的5×3矩形区域的数据C2E6。不要使用此区域的第一行作为变量名。

T = readtable('patients.xls',“范围”,“C2: E6”,'ReadVariableNames'假)
T = Var1, Var2, Var3, a = Var1, Var2, Var3, a = Var1, Var3, a = Var1, Var3, a = Var1, Var3, a = Var1, Var3, a = Var1, Var3, a = Var1, Var3, a = Var1, Var3, a = Var1, Var3, a = Var1, Var3, a = Var1

T包含默认变量名。

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

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

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

检查类型属性的变量TaxiInTaxiOut

getvaropts(OPTS,{“TaxiIn”,“TaxiOut”})
带有属性:Name类型FillValue TreatAsMissing QuoteRule前缀后缀EmptyFieldRule WhitespaceRule

更改变量的类型TaxiInTaxiOut

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

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

opts.SelectedVariableNames = {“TaxiIn”,“TaxiOut”};

使用readtable与选项一起函数对象导入选定的变量。显示表的汇总。

T = readtable(“airlinesmall.csv”,选择采用);概要(T)
变量:TaxiIn: 123523x1双值:Min 0中值5 Max 1451数失踪37383双值:Min 0中值13 Max 755数失踪37364

用于检测电子表格文件导入选项,指定变量导入,然后读取数据。

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

选择= detectImportOptions ('patients.xls')
OPTS = SpreadsheetImportOptions与属性:表属性:表:“”替换属性:MissingRule:“填充” ImportErrorRule:“填充”变量导入属性:集类型按名称使用setvartype VariableNames:{“名字”,“性别”,“年龄”...和7个}变量类型:{ '字符', '焦', '双' ......和7个} SelectedVariableNames:{ '姓氏', '性别', '年龄' ......和7个} VariableOptions:Show all 10 VariableOptions Access VariableOptions sub-properties using setvaropts/getvaropts PreserveVariableNames: false Range Properties: DataRange: 'A2' (Start Cell) VariableNamesRange: 'A1' RowNamesRange: '' VariableUnitsRange: '' VariableDescriptionsRange: '' To display a preview of the table, use preview

修改选项对象指定变量导入。

opts.SelectedVariableNames = {“收缩”,“舒张”};

采用readtable连同选项对象一起导入指定的变量。

T = readtable('patients.xls',选择采用);概要(T)
变量:收缩期:100X1双值:109最小122平均138最大舒张:100X1双值:最小68平均81.5最大99

您可以同时保留变量名称,其中包括任何字符,包括空格和非ASCII字符读取表格数据。首先,创建任意变量名称的表和表写入一个文本文件。然后,读取表格数据后面同时保留原来的变量名。

创建一个表包含任意变量名和表格数据写入到文件'sampletable.txt'

名字= {“桑切斯”;'约翰逊';“礼”;“Diaz”;'棕色'};年龄=[38,43岁,38;40;49);吸烟者=逻辑([1,0,1,0,1]);varNames = {'姓','年龄','吸烟者(1或0)'};T =表(LastName、年龄、抽烟,“VariableNames”,varNames)
T =5×3表姓名年龄吸烟者(1或0)___________ ___售予{桑切斯的}38真{“约翰逊”}43假{‘李’}38真{“Diaz”} 40假{“棕色”}49真的
writetable (T)'sampletable.txt')

阅读表格数据回用readtable。在默认情况下,MATLAB®将任何包含空格和非ascii字符的变量名转换为有效的MATLAB®标识符。例如,MATLAB®转换变量名'姓'“姓”'吸烟者(1或0)'“Smoker_1or0_”。要读取表格数据同时保存变量名,设置“PreserveVariableNames”参数真正

T_preserve = readtable ('sampletable.txt',“PreserveVariableNames”,真正)
T_preserve =5×3表姓名年龄吸烟者(1或0)___________ ___售予{桑切斯的}38 43 0 1{“约翰逊”}{‘李’}38 1 {“Diaz”} 40 0{“棕色”}49 1

输入参数

全部收缩

读取文件,指定为矢量字符或字符串标量的名称。

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

位置

形式

在MATLAB当前文件夹或文件夹®路径

中指定文件的名称文件名

例:'MYFILE.TXT'

文件的文件夹中

如果文件不是在当前文件夹或MATLAB路径上的文件夹中,然后指定的完整或相对路径名文件名

例:'C:\ MyFolder文件\ myFile.xlsx'

例:“dataDir \ myFile.txt”

偏远的地点

如果文件存储在远程位置,则文件名必须包含指定为表单的统一资源定位符(URL)的文件的完整路径:

采用scheme_name://文件路径/my_file.ext

根据您的位置偏远,采用scheme_name可以是该表中的一个值。

偏远的地点 采用scheme_name
亚马逊S3™ S3
Windows Azure的®Blob存储 wasb,wasbs
HDFS™ hdfs

有关更多信息,请参见与远程数据,

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

  • 如果文件名包括文件扩展名,然后进口函数确定来自扩展名的文件格式。否则,您必须指定'文件类型'名称 - 值对的参数来表示文件的类型。

  • 在Windows®与微软系统®高强®软件,进口函数读取您的Excel版本认可的Excel电子表格文件格式。

  • 如果您的系统没有用于Windows的Excel,或者您正在使用MATLAB在线™,则导入函数对UseExcel属性设置为,只有读.xls, .xlsx, .xlsm, .xltx,和。xltm文件。

  • 对于分隔的文本文件,该文件中的导入功能将空字段要么(对于数值变量)或空字符向量(对于文本变量)。文本文件中的所有行必须具有相同数量的分隔符。导入函数将忽略文件中不重要的空白。

数据类型:烧焦|字符串

文件导入选项,指定为SpreadsheetImportOptions,DelimitedTextImportOptions, 要么FixedWidthImportOptions目的是通过创建detectImportOptions函数。的选择对象包含控制数据导入过程的性质。有关每个对象的属性的详细信息,请参阅相应对象的页面。

文件类型 输出
电子表格文件 SpreadsheetImportOptions对象
文本文件 DelimitedTextImportOptions对象
宽度固定的文本文件 FixedWidthImportOptions对象

名称-值对的观点

指定可选的逗号分隔的对名称,值参数。名称是参数的名称和是对应的值。名称必须出现引号内。您可以按照任何顺序指定多个名称和值对参数名1,值1,...,NameN,值N

例:'ReadVariableNames',假指示文件的第一行不对应于变量名。

当阅读:

  • 文本文件,只有这些参数名称申请:文件类型,ReadVariableNames,ReadRowNames,TreatAsEmpty,DatetimeType,分隔符,HeaderLines,格式,EmptyValue,MultipleDelimsAsOne,CollectOutput,CommentStyle,ExpChars,行结束,DateLocale编码

  • 电子表格文件,只有这些参数名称申请:文件类型,ReadVariableNames,ReadRowNames,TreatAsEmpty,DatetimeType,,范围,UseExcelTextType

  • 与文本或电子表格文件选择导入选项,只有这些参数名适用:ReadVariableNames,ReadRowNames,DateLocale,编码,UseExcel

文本和电子表格文件

全部收缩

文件类型,由逗号分隔的对组成'文件类型'“文本”要么“电子表格”

指定'文件类型'名称 - 值对的参数,当文件名不包括文件扩展名,或扩展名不是下列其中一种:

  • 。文本文件,.DAT, 要么. csv用于分隔的文本文件

  • xls,.xlsb,.XLSM,.xlsx,.xltm,.xltx, 要么.ods档案电子表格文件

例:“文件类型”,“文本”

数据类型:烧焦|字符串

指示符,用于将第一行作为变量名读取,指定为逗号分隔的对'ReadVariableNames',要么真正,,1, 要么0。如果未指定的,readtable自动检测的变量名的存在。

指示器

描述

真正

当使用区域来读取第一行包含表的变量名。readtable为其中的每一列创建一个带有检测到的变量名的变量T

使用时,该地区的读第一行包含表中的数据。readtable创建窗体的默认变量名“Var1”,…,“VarN”,在那里N是变量的数目。

不明 当离开不明,readtable自动检测真正要么并相应收益。

注意:如果'ReadVariableNames'“ReadRowNames”逻辑指标真正, 然后readtable在该地区的第一行的第一列保存名称中的财产作为第一个维度的名字读,T.Properties.DimensionNames

如果你指定ReadVariableNames除…之外选择导入选项,然后readtable基于规范的行为变化:

  • 如果ReadVariableNames真正方法,然后从指定文件中读取变量名VariableNamesRange或者VariableNamesLine导入选项对象的属性。

  • 如果ReadVariableNames,然后读取从变量名VariableNames导入选项对象的属性。

指示符,用于将第一列作为行名称读取,指定为逗号分隔的对“ReadRowNames”,要么,真正,0, 要么1

指示器

描述

当要读取的区域的第一列包含数据,而不是表的行名时使用。

真正

当要读取的区域的第一列包含表的行名时使用。

不明 当离开不明,readtable假设

注意:如果'ReadVariableNames'“ReadRowNames”逻辑指标真正, 然后readtable在该地区的第一行的第一列保存名称中的财产作为第一个维度的名字读,T.Properties.DimensionNames

如果你指定ReadRowNames除…之外选择导入选项,那么readtable基于规范的行为变化:

  • 如果ReadRowNames真正方法,然后从指定文件中读取行名称RowNamesRange或者RowNameColumn导入选项对象的属性。

  • 如果ReadRowNames,那么不导入行的名称。

占位符文本以治疗为空值,指定为逗号分隔的一对组成的'TreatAsEmpty'和字符向量,特征向量,字符串或字符串数​​组的单元阵列。对应于这些字符的表元素被设置为

'TreatAsEmpty'仅适用于文件中的数字列,并且readtable不接受数字文字,如'-99'

例:'TreatAsEmpty', 'N / A'要么“TreatAsEmpty”、“N / A”N /一个在数字列中

例:'TreatAsEmpty',{ ' '' NA', 'N / A'}要么“TreatAsEmpty”, (“。”,“NA”、“N / A”),NAN /一个在数字列中

数据类型:烧焦|字符串

键入导入的文本数据,指定为逗号分隔的一对组成的“TextType”,要么“字符”要么“字符串”

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

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

例:“TextType”、“生物炭”

输入日期和时间数据的类型,指定为逗号分隔的对“DatetimeType”这些值之一:'约会时间',“文本”, 要么“exceldatenum”。价值“exceldatenum”仅适用于电子表格文件,不适用于文本文件。

键入导入的日期和时间数据
'约会时间'

MATLABdatetime数据类型

有关更多信息,请参见datetime

“文本”

如果“DatetimeType”被指定为“文本”,然后进口日期和时间数据的类型取决于在所指定的值“TextType”参数:

  • 如果“TextType”设定为“字符”,则导入函数将日期作为字符向量的单元格数组返回。

  • 如果“TextType”设定为“字符串”,然后进口函数返回日期作为字符串的数组。

“exceldatenum”

Excel中的序列日期数字

串行日期数是单一的数等于天数从一个给定的基准日期。Excel中的序列日期数字使用比MATLAB序列日期编号不同的参考日期。有关Excel的日期的详细信息,请参阅https://万博1manbetxsupport.microsoft.com/en-us/kb/214330

数据类型:烧焦|字符串

标志保持变量名,指定为逗号分隔的一对组成的PreserveVariableNames,要么真正, 要么

  • 真正- 保留变量名是无效MATLAB标识,如包括空格和非ASCII字符变量名。

  • - 转换无效的变量名称(如由确定isvarname功能),有效MATLAB标识符。

从R2019b开始,变量名和行名可以包含任何字符,包括空格和非ascii字符。而且,它们可以以任何字符开头,而不仅仅是字母。变量名和行名不必是有效的MATLAB标识符(由isvarname功能)。若要保留这些变量名和行名,请设置PreserveVariableNames真正

只有文本文件

全部收缩

字段分隔符字符,指定为逗号分隔的对“分隔符”以及字符向量、字符向量的单元数组或字符串。指定分隔符使用任何有效的字符如逗号”、“或一段时间内“。”

下表列出了一些常用的字段分隔符。

说明符

字段分隔符

”、“

“逗号”

逗号

“”

'空间'

空间

' \ t '

'标签'

标签

“;”

'半'

分号

“|”

“酒吧”

竖线

不明

如果未指定的,readtable自动检测分隔符。

要连续分隔符视为一个分隔符,指定分隔符作为字符向量的单元阵列。此外,您还必须指定MultipleDelimsAsOne选项。

例:'分隔符', ''要么“分隔符”,“逗号”

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

要在文件开头跳过的行,指定为逗号分隔的对,由“HeaderLines”一个正整数。如果未指定的,readtable自动检测线跳过数。

数据类型:|

该文件的列格式,指定为逗号分隔的一对组成的“格式”和字符向量或中的一个或多个转换说明的字符串标量。转换标识符是作为说明符接受由相同的textscan函数。

指定格式可以显著提高速度,一些大的文件。如果没有指定的值格式, 然后readtable使用%q解读非数字列。的%q说明符读取文本并省略双引号() 如果合适的话。

默认情况下,创建的变量或者是或字符向量的单元阵列,这取决于数据。如果整列是数字,变量输入为。如果在一列中的任何元素不是数字,变量被导入为特征向量的单元阵列。

数据类型:烧焦|字符串

在分隔文本文件空数字字段返回的值,指定为逗号分隔的一对组成的'EmptyValue'和一个标量。

多个定界符处理,指定为逗号分隔的一对组成的“MultipleDelimsAsOne”,要么真正要么。如果真正,然后进口函数将连续的分隔符作为一个单一的分隔符。由空格分开的重复分隔符也被视为单个分隔符。你还必须指定分隔符选项。

例:'MultipleDelimsAsOne',1

逻辑指示符确定数据级联,指定为逗号分隔的一对组成的'CollectOutput',要么真正要么。如果真正,则导入函数将同一基本MATLAB类的连续输出单元连接成单个数组。

符号指定文本忽略,指定为逗号分隔的一对组成的'CommentStyle'和字符向量,特征向量,字符串或字符串数​​组的单元阵列。

例如,指定一个字符,如'%'忽略同一行中符号后面的文本。指定由两个字符向量组成的单元格数组,例如{“/ *”、“* /”},以忽略这些序列之间的任何文本。

MATLAB只在每个字段的开头检查注释,而不检查字段内的注释。

例:CommentStyle, {“/ *”、“* /”}

数据类型:烧焦|字符串

指数字符,指定为逗号分隔的一对组成的“ExpChars”和字符向量或字符串。默认的指数字符e,E,dD

数据类型:烧焦|字符串

行尾字符,由逗号分隔的对组成'行结束'和字符向量或字符串。字符载体必须是'\ r \ N'或者它必须指定单个字符。常见的行尾字符是换行字符(' \ n ')或回车(' \ r ')。如果您指定'\ r \ N',则导入函数处理任何\ r,\ n,两者的结合(\ r \ n)作为结束行字符。

端的行的默认序列是\ n,\ r, 要么\ r \ n,这取决于文件的内容。

如果存在缺少值,并在文件的最后一行的末尾的结束线序,然后进口函数返回这些字段为空值。这确保了单个细胞在输出单元阵列,C,大小相同。

例:‘EndOfLine’,‘:’

数据类型:烧焦|字符串

用于读取日期的区域设置,指定为逗号分隔的对'DateLocale'和字符向量或形式的字符串标量XX_YY其中:

  • YY是表示国家的大写ISO 3166-1 alpha-2代码。

  • XX是一个表示语言的小写ISO 639-1双字母代码。

有关区域设置的公共值列表,请参见语言环境的名称 - 值对参数datetime函数。

当使用%d格式说明读取文本datetime值,使用DateLocale要指定导入函数应该在其中解释月份和星期几名称和缩写的区域设置。

如果你指定DateLocale除…之外选择导入选项,那么进口功能利用指定的值DateLocale参数,重写导入选项中定义的区域设置。

例:'DateLocale', 'Ja_JP表示'

字符编码方案与文件相关联,指定为逗号分隔的一对组成的“编码”“系统”或标准字符编码方案名称等在此表中的值之一。如果不指定任何编码或编码指定为“系统”中,readtable函数使用系统默认编码读取文件。

“中文”

'ISO-8859-1'

'窗口-874'

'中文-HKSCS'

'ISO-8859-2'

'窗口-949'

“CP949”

'ISO-8859-3'

“windows - 1250”

“EUC-KR”

'ISO-8859-4'

“windows - 1251”

'EUC-JP'

'ISO-8859-5'

“windows - 1252”

'EUC-TW'

'ISO-8859-6'

“windows - 1253”

'GB18030'

'ISO-8859-7'

'窗口-1254'

“GB2312”

'ISO-8859-8'

'窗口-1255'

“GBK”

'ISO-8859-9'

'窗口-1256'

“IBM866”

'ISO-8859-11'

'窗口-1257'

“KOI8-R”

'ISO-8859-13'

“windows - 1258”

“KOI8-U”

'ISO-8859-15'

“us - ascii”

“麦金塔”

'UTF-8'

'SHIFT_JIS'

如果你指定编码除…之外选择导入选项,然后readtable函数使用对指定的值编码参数,它将覆盖导入选项定义的编码。

例:“编码”,'UTF-8'

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

数据类型:烧焦|字符串

从文本文件的持续时间数据的输出的数据类型,指定为逗号分隔的一对组成的'DurationType',要么“持续时间”要么“文本”

输入持续时间数据的类型
“持续时间”

MATLAB持续时间数据类型

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

“文本”

如果'DurationType'被指定为“文本”,然后进口持续时间数据的类型取决于在所指定的值“TextType”参数:

  • 如果“TextType”“字符”,则导入函数将持续时间数据作为字符向量的单元数组返回。

  • 如果“TextType”“字符串”,然后进口函数返回的持续时间数据作为一个字符串数组。

数据类型:烧焦|字符串

电子表格文件只

全部收缩

要读取的工作表,指定为逗号分隔的对“表”表示工作表索引或包含工作表名称的字符向量或字符串的正整数。工作表名称不能包含冒号(:)。要确定电子表格文件中工作表的名称,请使用片材= sheetnames(文件名)。有关更多信息,请参见sheetnames

如果你指定除…之外选择导入选项,然后readtable函数使用对指定的值参数,覆盖导入选项中定义的工作表名称。

例:“表”,2

例:“表”,“MySheetName”

例:“表”,“MySheetName”

数据类型:烧焦|字符串|||INT8|INT16|INT32|int64|uint8|uint16|uint32|uint64

工作表以读,指示为由逗号指定的矩形区域的部分分开一对组成的“范围”和下列形式之一的字符向量或字符串标量。

方法来指定范围 描述

Corner1: Corner2

矩形范围

使用语法指定范围Corner1: Corner2,在那里Corner1Corner2两个相反的角落定义了这个区域。例如,'D2:H4'表示两个角之间的3×5的矩形区域D2H4在工作表上。的“范围”名称 - 值对的说法是不区分大小写,并使用Excel的A1引用样式(请参阅Excel的帮助)。

例:'范围', 'Corner1:Corner2'

“”

未指定或空

如果未指定的,readtable自动检测使用范围。

例:“范围”,“

注意:使用范围指的是实际上包含数据电子表格的矩形部分。readtable自动检测通过修整不包含任何数据的前缘和后的行和列所使用的范围。文本即只有白色空间被认为是数据,并且所使用的范围内被捕获。

第一行:Row2

行范围

您可以通过指定的开始和结束使用Excel列代号行识别范围。然后readtable自动检测指定行中使用的列范围。例如,readtable解释范围说明“1:7”通过7(含)读取所有列以行1所使用的范围的指令。

例:“范围”、“1:7的

列1:列2

列范围

可以使用Excel列指定器指定开始列和结束列来标识范围。然后readtable自动检测指定的列内所使用的行范围。例如,readtable解释范围说明“答:F”用于读取A到F(包括)列中使用范围内的所有行。

例:“范围”、“答:F '

NamedRange

Excel的命名范围

在Excel中,您可以创建名称来标识电子表格中的范围。例如,您可以选择电子表格的一个矩形部分并调用它'myTable的'。如果电子表格中存在这样的命名范围,则readtable可以使用其名称读取范围。

例:“范围”、“myTable”

例:“范围”,'A1:F10'

例:“范围”,“A1:F10”

数据类型:烧焦|字符串

标志开始的一个实例Microsoft Excel中对于Windows在读取电子表格数据时,指定由逗号分隔的对组成'UseExcel',要么真正, 要么

您可以设置'UseExcel'参数将这些值中的一个:

  • 真正-导入函数在读取文件时启动microsoftexcel的一个实例。

  • -导入函数在读取文件时不会启动microsoftexcel的实例。在此模式下操作时,导入函数功能在支持文件格式和交互式特性(如公式和宏)方面有所不同。万博1manbetx

UseExcel

真正

万博1manbetx支持的文件格式

.xls, .xlsx, .xlsm, .xltx, .xltm, .xlsb, .ods

.xls的,.XLSX,.XLSM,.xltx,.xltm

万博1manbetx交互功能,如公式和宏支持

是的

没有

从电子表格文件中读取Windows平台上的时候,如果要启动的实例Microsoft Excel中,然后设置'UseExcel'参数真正

输出参数

全部收缩

输出表,作为表返回。表可以存储诸如描述、变量单元、变量名称和行名称等元数据。有关更多信息,请参见属性部分

提示

  • 在XLSX格式的大文件有时加载缓慢。为了更好的导入和导出性能,Microsoft建议您使用XLSB格式。

介绍了R2013b