主要内容

readtable

从文件创建表

描述

例子

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

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

  • . txt,.dat,或. csv分隔的文本文件

  • xls,.xlsb,.xlsm,.xlsx,.xltm,.xltx,或。ods电子表格文件

readtable创建一个变量T每一列的文件和读取文件的第一行的变量名。默认情况下,readtable创建变量数据类型适合的数据值在每一列中发现的输入文件。

例子

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

例子

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

设置特定的导入选项为您的数据,您可以使用选择对象或您可以指定名称-值对。当你除了指定名称-值对选择,然后readtable金宝app只支持这些名称-值对:

  • ——文本和表格参数ReadVariableNames,ReadRowNames

  • 文本只有参数-DateLocale,编码

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

例子

全部折叠

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

文件名=“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

从R2020a,readtable函数读取一个输入文件,好像它会自动调用detectImportOptions函数文件。它可以检测数据类型,丢弃额外的标题行,并填写缺失的值。

例如,预览文件headersAndMissing.txt在文本编辑器中。文件一行与列名称,另一头。最后两行有差距,前一行数据值。

从文件创建一个表。的readtable函数丢弃头。此外,它填补了缺口以适当的价值)值为数值型变量和一个空字符文本向量。

T = readtable (“headersAndMissing.txt”)
T =5×6表LastName性别年龄身高体重吸烟者___________ __________看上去___长得一样{‘吴’}{“M”} 38 71 176 1{“约翰逊”}{“M”} 43 69 163 0{桑切斯的}{' F '} 38 64 131 0{“棕色”}{' F '}南67 133 0{“皮卡”}{0 x0 char}南64 119 0

恢复默认行为从以前的版本中,指定“格式”、“汽车”名称-值对的论点。readtable读取标题数据,因此,它将所有的表变量转换为文本。

T = readtable (“headersAndMissing.txt”,“格式”,“汽车”)
T =6×6表LastName性别年龄身高体重吸烟者___________ __________ __________ ____ ____ ___________{'字符串'}{'字符串'}{“int”} {“int”} {“int”}{“布尔”}{‘吴’}{“M”}{“38”}{71”}{176”}{1}{“约翰逊”}{“M”}{“43”}{69”}{163”}{' 0 '}{桑切斯的}{' F '}{“38”}{64”}{131”}{' 0 '}{“棕色”}{' F '} {0 x0 char}{67”}{133”}{' 0 '}{“皮卡”}{0 x0 char} {0 x0 char} {64”} {119”} {' 0 '}

有关更多信息,请参见本页兼容性考虑部分。

预览文件mySpaceDelimTable.txt在文本编辑器中。一个屏幕截图如下所示。注意,文件包含空间分隔,面向列的数据。

创建一个表空间分隔的文本文件。的readtable函数分配默认的变量名Var1Var5因为文件不包含检测列名的第一行。

T = readtable (“mySpaceDelimTable.txt”)
T =3×5表Var1 Var2 Var3 Var4 Var5 _____ _____ _____ _____ _____ {“M”} 45 45{“纽约”}{“真实”}{' F '} 41 32 {“CA”}{“假”}{“M”} 40 34{‘马’}{“假”}

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

文件名=“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,% uuint32

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

预览文件german_dates.txt在文本编辑器中。一个屏幕截图如下所示。注意,第一列的值包含日期在德国和第二和第三列数值。

阅读使用的示例文件readtable。转换说明符是% D日期和% f浮点值。指定文件编码使用FileEncoding名称-值对的论点。指定日期的格式和语言环境使用DateLocale名称-值对的论点。

T = readtable (“german_dates.txt”,“格式”,' % D {dd嗯yyyy} % f % f ',“FileEncoding”,“iso - 8859 - 15”,“DateLocale”,“de_DE”)
T =3×3表Var1 Var2 Var3 ___________ ___ _____, 2014年1月01 21.6 - 102.7 20.2 - 100.5 2014年2月1日2014年3月01 20.7 - 99.8

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

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

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

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

查看DimensionNames表的属性。

T.Properties.DimensionNames
ans =1 x2单元格{' LastName}{}“变量”

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

创建一个表,使用的数据来自一个指定区域的电子表格patients.xls。使用数据从5-by-3矩形区域之间的角落C2E6。不要使用这个地区的第一行作为变量名。

T = readtable (“patients.xls”,“范围”,“C2: E6”,“ReadVariableNames”假)
T = Var1 Var2 Var3 ___________________________上38 43县综合医院71 VA医院69年38圣玛丽医疗中心64年40 VA医院67年49个县综合医院64年

T包含默认的变量名。

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

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

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

检查类型属性的变量TaxiInTaxiOut

getvaropts(选择,{“TaxiIn”,“TaxiOut”})
ans = 1 x2 TextVariableImportOptions数组属性:名称类型FillValue TreatAsMissing QuoteRule前缀后缀EmptyFieldRule WhitespaceRule

改变变量的类型TaxiInTaxiOut

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

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

选择。SelectedVariableNames = {“TaxiIn”,“TaxiOut”};

使用readtable函数以及选择对象导入选定的变量。显示表的一个总结。

T = readtable (“airlinesmall.csv”、选择);总结(T)
变量:TaxiIn: 123523 x1双重价值:最小0值5最大1451 NumMissing 37383 TaxiOut: 123523 x1双重价值:最小0值13最大755 NumMissing 37364

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

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

选择= detectImportOptions (“patients.xls”)
选择= SpreadsheetImportOptions属性:表属性:表:“替代属性:MissingRule:“填补”ImportErrorRule:“填补”变量导入属性:设置类型的名字使用setvartype VariableNames:{“姓”、“性别”、“年龄”……和7}VariableTypes:{“字符”,“字符”,“双”……和7}SelectedVariableNames:{“姓”、“性别”、“年龄”……和7}VariableOptions:显示所有10 VariableOptions访问VariableOptions sub-properties使用setvaropts / getvaropts VariableNamingRule:“修改”范围属性:DataRange:“A2”(启动细胞)VariableNamesRange:“A1”RowNamesRange: VariableDescriptionsRange:“VariableUnitsRange:显示一个表的预览,预览使用

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

选择。SelectedVariableNames = {“收缩”,舒张压的};

使用readtable随着选择对象导入指定的变量。

T = readtable (“patients.xls”、选择);总结(T)
变量:收缩压:100 x1双重价值:109分钟122 Max 138舒张中位数:100 x1双重价值:最小68中位数81.5最大99

你可以阅读表格数据,同时保留变量名称,包括任何字符,包括空格和非ascii字符。首先,创建一个表任意变量名和表写入文本文件。然后,阅读表格数据,同时保留原始变量名。

创建一个表包含任意变量名称并将表格数据写入文件“sampletable.txt”

LastName = {“桑切斯”;“约翰逊”;“李”;“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_”。阅读表格数据,同时保留变量名,设置“VariableNamingRule”参数保存

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

你可以阅读十六进制和二进制数字从一个文件中并将它们作为数值变量存储在一个表。的readtable函数会自动读取十六进制,包括二进制数0 x0 b前缀。数值存储使用整数数据类型。您还可以使用导入选项时读这些数字没有前缀。

预览hexAndBinary.txt文件在文本编辑器中。它有列的十六进制和二进制数字前缀,并没有一列。

读取文件使用readtable。功能检测的数字0 x0 b前缀并将它们存储为整数。第三列没有前缀值被视为文本。

T = readtable (“hexAndBinary.txt”)
T =3×4表Var1 Var2 Var3 Var4 _____ _____ ________ ___________ 255 255 {‘C7F9} {‘Device1} 256年4{05男朋友'}{‘Device2} 43981 129 {‘F00F} {' Device3 '}

readtable函数将数值存储在不同的整数类(uint16uint8),因为T.Var1有一个值,需要超过8位的存储。

类(T.Var1)
ans = ' uint16 '
类(T.Var2)
ans = ' uint8 '

指定的数据类型存储数值从十六进制进口和二进制数字,使用“HexType”“BinaryType”名称-值对参数。存储值作为签署了32位整数。

T = readtable (“hexAndBinary.txt”,“HexType”,“int32”,“BinaryType”,“int32”);类(T.Var1)
ans = ' int32 '
类(T.Var2)
ans = ' int32 '

您可以使用导入选项来检测十六进制和二进制数字没有前缀,并指定存储。创建一个对象导入选项hexAndBinary.txt

选择= detectImportOptions (“hexAndBinary.txt”)
选择= DelimitedTextImportOptions属性:格式属性:分隔符:{" "}空白:“\ b \ t”LineEnding: {' \ n ' ' \ r \ r \ n”} CommentStyle: {} ConsecutiveDelimitersRule:“分裂”LeadingDelimitersRule:“保持”TrailingDelimitersRule:“忽略”EmptyLineRule:“跳过”编码:“utf - 8”替代属性:MissingRule:“填补”ImportErrorRule:“填补”ExtraColumnsRule:“addvars”变量导入属性:设置类型的名字使用setvartype VariableNames: {‘Var1’,‘Var2’,‘Var3’……和1}VariableTypes:{“汽车”,“汽车”,“字符”……和1}SelectedVariableNames: {‘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”)
选择= DelimitedTextImportOptions属性:格式属性:分隔符:{" "}空白:“\ b \ t”LineEnding: {' \ n ' ' \ r \ r \ n”} CommentStyle: {} ConsecutiveDelimitersRule:“分裂”LeadingDelimitersRule:“保持”TrailingDelimitersRule:“忽略”EmptyLineRule:“跳过”编码:“utf - 8”替代属性:MissingRule:“填补”ImportErrorRule:“填补”ExtraColumnsRule:“addvars”变量导入属性:设置类型的名字使用setvartype VariableNames: {‘Var1’,‘Var2’,‘Var3’……和1}VariableTypes:{“汽车”,“汽车”,“int32”……和1}SelectedVariableNames: {‘Var1’,‘Var2’,‘Var3’……和1}VariableOptions:显示所有4 VariableOptions访问VariableOptions sub-properties使用setvaropts / getvaropts VariableNamingRule:“修改”位置属性:DataLines:[1正]VariableNamesLine: 0 RowNamesColumn: 0 VariableUnitsLine: 0 VariableDescriptionsLine: 0显示表的预览,预览使用

读取文件并导入第三列数值,而不是文本。

T = readtable (“hexAndBinary.txt”选择)
T =3×4表Var1 Var2 Var3 Var4 _____ _____ _____ ___________ 255 255 51193 {‘Device1} 256 4 1471 {‘Device2} 43981 129 61455 {' Device3 '}

输入参数

全部折叠

指定名称的文件阅读,作为特征向量或一个字符串标量。

根据你的文件的位置,文件名可以承担其中的一个形式。

位置

形式

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

指定文件的名称文件名

例子:“myFile.txt”

文件在一个文件夹

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

例子:“C: \ myFolder \ myFile.xlsx”

例子:“dataDir \ myFile.txt”

远程位置

如果文件存储在一个偏远的位置,然后文件名必须包含文件的完整路径指定为一个统一资源定位符(URL)的形式:

scheme_name:/ /path_to_file/my_file.ext

基于你的远程位置,scheme_name这个表中的值之一。

远程位置 scheme_name
Amazon S3™ s3
Windows Azure®Blob存储 wasb,wasbs
HDFS™ hdfs

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

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

  • 如果文件名包括文件扩展名,然后导入函数决定的文件格式扩展。否则,你必须指定“文件类型”名称-值对参数来表示文件的类型。

  • 在Windows上®与微软系统®Excel®任何Excel电子表格软件,导入函数读取Excel文件格式被你的版本。

  • 如果您的系统没有Excel为Windows或如果您正在使用MATLAB在线™、导入功能的运行UseExcel属性设置为,只读取xls, .xlsx .xlsm、.xltx .xltm文件。

  • 分隔的文本文件,导入函数转换文件中的空字段(对于一个数值型变量)或一个空字符向量(一个文本变量)。文本文件中的所有行必须有相同数量的分隔符。导入函数忽略了无关紧要的文件中的空白。

数据类型:字符|字符串

文件导入选项,指定为一个SpreadsheetImportOptions,DelimitedTextImportOptions,或FixedWidthImportOptions创建的对象detectImportOptions函数。的选择对象包含的属性控制数据导入过程。对每个对象的属性的更多信息,参见相应的页面对象。

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

名称-值对的观点

指定可选的逗号分隔条名称,值参数。的名字参数名称和吗价值相应的价值。的名字必须出现在引号。您可以指定几个名称和值对参数在任何顺序Name1, Value1,…,的家

例子:“ReadVariableNames”,假的表明文件的第一行不对应的变量名。

当阅读:

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

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

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

文本和电子表格文件

全部折叠

类型的文件,指定为逗号分隔组成的“文件类型”和其中一个值。

价值 选择文件导入
“表格”

返回一个SpreadsheetImportOptions对象。

“文本”

返回一个DelimitedTextImportOptionsFixedWidthImportOptions对象根据文本文件的布局。

“delimitedtext”

返回一个DelimitedTextImportOptions对象。使用这个选项列由分隔符分隔的文本文件。

“fixedwidth”

返回一个FixedWidthImportOptions对象。使用这个选项列固定宽度的文本文件。

使用“文件类型”名称-值对的观点时文件名不包括文件扩展名,或者当扩展并非其中之一:

  • . txt,.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”这些值之一:“datetime”,“文本”,或“exceldatenum”。的值“exceldatenum”只适用于电子表格文件,并为文本文件是无效的。

价值 进口日期和时间数据类型
“datetime”

MATLABdatetime数据类型

有关更多信息,请参见datetime

“文本”

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

  • 如果“TextType”被设置为“字符”,那么导入函数返回日期的单元阵列特征向量。

  • 如果“TextType”被设置为“字符串”,那么导入函数返回日期作为一个字符串数组。

“exceldatenum”

Excel串行日期数字

串行的日期数一个数字等于给定的参考日期的天数。Excel串行数据使用不同的参考日期比MATLAB数字串行日期。Excel日期的更多信息,请参阅https://金宝appsupport.microsoft.com/en-us/kb/214330

数据类型:字符|字符串

国旗保护变量名称,指定为逗号分隔组成的VariableNamingRule,要么真正的,或

  • “保存”——保存变量名是无效的MATLAB标识符,如变量名,包括空间和非ascii字符。

  • “修改”——转换无效变量名(如决定的isvarnameMATLAB函数)来有效的标识符。

从R2019b,变量名和行名称可以包含任何字符,包括空格和非ascii字符。同时,他们不仅可以从任何字符,字母。变量和行名称不需要有效的MATLAB标识符(如决定的isvarname功能)。保存这些变量名和行名称,设置的值VariableNamingRule“保存”

数据类型:字符|字符串

文本文件只

全部折叠

字段分隔符字符,指定为逗号分隔组成的“分隔符”一个特征向量,特征向量的单元阵列,或一个字符串。指定分隔符使用任何有效的字符如一个逗号”、“或一段时间内“。”

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

说明符

字段分隔符

”、“

“逗号”

逗号

' '

“空间”

空间

' \ t '

“标签”

选项卡

“;”

“半”

分号

“|”

“酒吧”

竖线

未指明的

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

治疗连续分隔符作为一个分隔符,指定分隔符作为一个单元阵列的特征向量。此外,您还必须指定MultipleDelimsAsOne选择。

例子:“分隔符”、“,”“分隔符”、“逗号”

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

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

数据类型:|

列格式的文件,指定为逗号分隔组成的“格式”和一个特征向量或一个字符串标量拥有一个或多个转换说明符,或“汽车”。转换说明符说明符接受的都是相同的textscan函数。

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

  • 如果你不指定“格式”名称-值对,那么readtable功能表现得好像你使用的结果detectImportOptions函数导入数据。这种行为的后果的更多信息,见兼容性的考虑

  • 如果您指定“格式”、“汽车”,然后创建的变量数组单元阵列特征向量,或datetime数组,根据数据。如果整个列数字、变量都是进口的。如果任何元素的列不是数字,变量是进口作为特征向量的细胞阵列,或datetime数组的值表示日期和时间。

数据类型:字符|字符串

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

多个分隔符处理,指定为逗号分隔组成的“MultipleDelimsAsOne”,要么真正的。如果真正的,然后导入函数对连续分隔符作为一个分隔符。重复分隔符分隔的空白也作为一个分隔符。您还必须指定分隔符选择。

例子:“MultipleDelimsAsOne”, 1

逻辑确定指标数据连接,指定为逗号分隔组成的“CollectOutput”,要么真正的。如果真正的,然后导入函数连接连续输出相同的基本MATLAB类的细胞到一个数组中。

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

例如,指定一个字符等“%”忽视文本符号在同一行。指定一个单元阵列的两个特征向量,如{“/ *”、“* /”}这些序列之间,忽略任何文本。

MATLAB检查评论只在每个字段的开始,不是在一个字段中。

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

数据类型:字符|字符串

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

数据类型:字符|字符串

行尾字符,指定为逗号分隔组成的“LineEnding”和一个字符或字符串向量。特征向量必须“\ r \ n”或者它必须指定一个字符。常见的行尾字符是一个换行符(' \ n ')或回车(' \ r ')。如果您指定“\ r \ n”,然后导入函数对待任何r \,\ n,两者的结合(\ r \ n)行尾字符。

默认的行结束序列\ n,r \,或\ r \ n,这取决于你的文件的内容。

如果有缺失值和最后一个行尾序列中的最后一行一个文件,然后导入函数返回空值的字段。这将确保单个细胞在输出单元阵列,C,都是一样的大小。

例子:‘LineEnding’,‘:’

数据类型:字符|字符串

语境对阅读日期,指定为逗号分隔组成的“DateLocale”和一个特征向量或一个字符串标量的形式xx_YY,地点:

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

  • xx是一个小写的ISO 639 - 1两个字母的代码显示语言。

语言环境的共同价值观,看到语言环境名称-值对的理由datetime函数。

当使用% D阅读文本格式说明符datetime值,使用DateLocale指定的地区进口函数应该解释,一周中的第几天名称和缩写。

如果你指定DateLocale参数除了选择导入选项,然后导入函数使用指定的值DateLocale论点,覆盖导入选项中定义的语言环境。

例子:“DateLocale”、“ja_JP”

字符编码方案相关文件,指定为逗号分隔组成的“编码”“系统”或一个标准字符编码方案的名字。当你不指定任何编码,readtable函数使用自动字符集检测来确定当读取文件的编码。

如果你指定“编码”参数除了导入选项,那么readtable函数使用指定的值“编码”中定义的编码,覆盖导入选项。

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

例子:“编码”、“系统”使用系统默认的编码。

数据类型:字符|字符串

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

价值 对进口持续时间数据的类型
“持续时间”

MATLAB持续时间数据类型

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

“文本”

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

  • 如果“TextType”“字符”,那么导入函数返回时间数据的单元阵列特征向量。

  • 如果“TextType”“字符串”,那么导入函数返回时间数据作为一个字符串数组。

数据类型:字符|字符串

输出十六进制数据的数据类型,指定为逗号分隔组成的“HexType”表中列出的值。

输入文件表示十六进制值为文本,使用0 x0 x作为前缀字符0- - - - - -9,一个- - - - - -f,一个- - - - - -F作为数字。(大写和小写字母表示相同的位数的例子,“0 xf”“0 xf”两个代表15。)

导入函数转换十六进制值指定的数据类型的值“HexType”

的价值“HexType”

输出表变量的数据类型

“汽车”

数据类型自动检测

“文本”

改变输入文本

“int8”

8位整数,签署了

“int16”

16位整数,签署了

“int32”

32位整数,签署了

“int64”

64位整数,签名

“uint8”

8位整数,无符号

“uint16”

16位整数,无符号

“uint32”

32位整数,无符号

“uint64”

64位整数,无符号

例子:“HexType”、“uint16”(如转换文本表示十六进制值“0 xff”16位无符号整数(如255年输出表中)。

数据类型:字符|字符串

输出数据类型的二进制数据,指定为逗号分隔组成的“BinaryType”表中列出的值。

输入文件代表二进制值为文本,使用0 b0 b作为前缀字符01作为数字。

导入函数将二进制值转换为指定的数据类型的值“BinaryType”

的价值“BinaryType”

输出表变量的数据类型

“汽车”

数据类型自动检测

“文本”

改变输入文本

“int8”

8位整数,签署了

“int16”

16位整数,签署了

“int32”

32位整数,签署了

“int64”

64位整数,签名

“uint8”

8位整数,无符号

“uint16”

16位整数,无符号

“uint32”

32位整数,无符号

“uint64”

64位整数,无符号

例子:“BinaryType”、“uint16”代表二进制值(如转换文本“0 b11111111”16位无符号整数(如255年输出表中)。

数据类型:字符|字符串

删除非数字字符的数字变量,指定为一个逻辑真正的

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

数据类型:逻辑

电子表格文件只

全部折叠

阅读工作表,指定为逗号分隔组成的“表”和一个正整数显示工作表索引或特征向量或字符串包含工作表的名称。工作表名称不能包含冒号(:)。确定的名称表电子表格文件,使用表= sheetnames(文件名)。有关更多信息,请参见sheetnames

如果你指定参数除了选择导入选项,然后readtable函数使用指定的值论点,覆盖导入选项中定义的表名称。

例子:“表”,2

例子:“表”,“MySheetName”

例子:“表”,“MySheetName”

数据类型:字符|字符串|||int8|int16|int32|int64|uint8|uint16|uint32|uint64

阅读部分的工作表,表示作为一个矩形区域指定逗号分隔两人组成的“范围”和一个字符向量或字符串标量在下列形式之一。

指定的方法范围 描述

“细胞”(行坳)

从细胞

指定的起始单元格数据作为特征向量或字符串标量或两个元素数值向量。

  • 特征向量或字符串标量包含一个列和行号使用Excel信A1符号。例如,A5的标识符是细胞在列的交集一个和行5

  • 两个元素数值向量的形式(行坳)表示开始的行和列。

使用细胞开始,导入函数自动检测数据的程度开始导入细胞开始和结束在最后空行或页脚。

例子:的A5(5 - 1)

Corner1: Corner2

矩形范围

使用语法指定范围Corner1: Corner2,在那里Corner1Corner2是两个对立的角落,定义该地区。例如,“D2: H4”代表了三五两角之间的矩形区域D2H4在工作表上。的“范围”名称-值对的论点是不区分大小写的,使用Excel A1参考样式(见Excel帮助)。

例子:“范围”、“Corner1: Corner2

不明或空

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

例子:“范围”,“

注意:使用范围指的矩形部分实际上包含数据的表格。readtable自动检测通过削减任何前导和尾随的使用范围不包含数据的行和列。文本只有白色的空间被认为是数据和捕获在使用范围内。

第一行:Row2

行范围

您可以识别范围指定开始和结束行用Excel行指示器。然后readtable自动检测中使用的列范围指定行。例如,readtable解释规范范围“1:7”作为一个指令读取所有列行1到7的使用范围(包容)。

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

Column1: Column2

列范围

您可以确定通过指定范围的开始和结束列使用Excel列指示器。然后readtable自动检测中使用的行范围指定列。例如,readtable解释规范范围“答:F”作为一个指导阅读范围用于列中的所有行通过F(包容)。

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

NamedRange

Excel的命名范围

在Excel中,您可以创建电子表格中的名称识别范围。例如,您可以选择一个矩形部分的电子表格和调用它“myTable”。如果这样的命名范围存在于一个电子表格,那么readtable可以阅读范围使用它的名称。

例子:“范围”、“myTable”

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

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

数据类型:字符|字符串

标志开始的一个实例Microsoft ExcelWindows时阅读的电子表格数据,指定为逗号分隔组成的“UseExcel”,要么真正的,或

你可以设置“UseExcel”参数的值:

  • 真正的——Microsoft Excel的导入功能启动一个实例时阅读该文件。

  • ——导入函数不开始Microsoft Excel当读取文件的一个实例。当操作在这种模式下,导入函数功能不同文件格式的支持和互动特性,如公式和宏。金宝app

UseExcel

真正的

金宝app支持文件格式

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

xls, .xlsx .xlsm、.xltx .xltm

金宝app支持交互式功能,如公式和宏

是的

没有

当阅读从电子表格文件在Windows平台上,如果你想开始的一个实例Microsoft Excel,然后设置“UseExcel”参数真正的

输出参数

全部折叠

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

提示

  • 大文件有时XLSX格式的加载速度很慢。为更好的导入和导出性能,微软建议您使用XLSB格式。

兼容性的考虑

全部展开

行为改变R2020a

介绍了R2013b