帮助中心帮助中心
detectImportOptions
从文件创建表
T =可读(文件名)
T =可读文件(filename,opts)
T =可读的(___、名称、值)
例子
T= readtable (文件名)通过从文件中读取面向列的数据来创建表。
T= readtable (文件名)
T
文件名
readtable从文件扩展名确定文件格式:
readtable
. txt,.dat,或. csv对于分隔的文本文件
. txt
.dat
. csv
xls,.xlsb,.xlsm,.xlsx,.xltm,.xltx,或。ods对于电子表格文件
xls
.xlsb
.xlsm
.xlsx
.xltm
.xltx
。ods
. xml用于扩展标记语言(XML)文件
. xml
。docx为微软®词文档文件
。docx
. html,名为. xhtml的,或. htm用于超文本标记语言(HTML)文件
. html
名为. xhtml的
. htm
对于文本和电子表格文件,readtable创建一个变量T,并从文件的第一行读取变量名。对于XML文件,readtable创建一个变量T对于作为表变量检测到的每个元素或属性节点。变量名对应于元素和属性名。为微软文字处理软件文档文件,readtable,默认情况下,从文档中的第一个表导入数据,并在中创建一个变量T,并从表的第一行读取变量名。对于HTML文件,readtable默认情况下,从第一个中导入数据<表>元素,并在中创建一个变量T,并从表的第一行读取变量名。
<表>
默认情况下,readtable创建具有适合于在输入文件的每列中检测到的数据值的数据类型的变量。
T= readtable (文件名,选择)使用导入选项创建一个表选择.
T= readtable (文件名,选择)
选择
T= readtable (___,名称,值)用一个或多个名称-值对参数指定的附加选项从文件创建表。例如,您可以指定是否readtable将文件的第一行作为变量名或数据读取。
T= readtable (___,名称,值)
名称,值
为数据设置特定的导入选项,可以使用选择对象,也可以指定名称-值对。时指定名称-值对选择,然后readtable万博1manbetx只支持这些名值对:
文本和电子表格参数-ReadVariableNames,ReadRowNames
ReadVariableNames
ReadRowNames
-纯文本参数DateLocale,编码
DateLocale
编码
电子表格参数-表,UseExcel
表
UseExcel
全部折叠
加载文件myCsvTable.dat并在文本编辑器中预览其内容。屏幕截图如下所示。注意,该文件包含以逗号分隔的面向列的数据。
myCsvTable.dat
文件名=“myCsvTable.dat”;
从逗号分隔的文本文件创建一个表。生成的表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在文本编辑器中。该文件的一行包含列名,另一行包含标题。在前两行有数据值的地方,最后两行有空白。
headersAndMissing.txt
从文件创建一个表。的readtable函数将丢弃头文件。此外,它用适当的缺失值填补空白——a南数值变量的值,文本的空字符向量。
南
T =可读的(“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 =可读的(“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在文本编辑器中。屏幕截图如下所示。注意,该文件包含以空格分隔的、面向列的数据。
mySpaceDelimTable.txt
从空格分隔的文本文件创建一个表。的readtable函数分配默认变量名Var1来Var5因为文件的第一行不包含可检测的列名。
Var1
Var5
T =可读的(“mySpaceDelimTable.txt”)
T =3×5表Var1 Var2 Var3 Var4 Var5 _____ ____ ____ ______ _________ {' 45 45 M '}{“纽约”}{“真实”}{' F '} 41 32{“CA”}{“假”}{“M”}40 34{‘马’}{“假”}
从逗号分隔的文本文件创建一个表。导入前两列作为字符向量,第三列作为uint32后两列为双精度浮点数。将最后一列的项作为字符向量导入。
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.
% s
% f
双
% u
从文件中读取德语日期,并将它们作为英语日期添加到表中。
预览文件german_dates.txt在文本编辑器中。屏幕截图如下所示。注意,第一列值包含德语日期,第二和第三列是数值。
german_dates.txt
使用读取示例文件readtable.转换说明符为% D日期和% f对于浮点值。方法指定文件编码FileEncoding名称-值对参数。方法指定日期的格式和区域设置DateLocale名称-值对参数。
% D
FileEncoding
T =可读的(“german_dates.txt”,...“格式”,'%{dd MMMM yyyy}D %f %f',...“FileEncoding”,“iso - 8859 - 15”,...“DateLocale”,“de_DE”)
T =3×3表Var1 Var2 Var3 ________________ _________ 2014年1月01 20.2 100.5 2014年2月01 21.6 102.7 2014年3月01 20.7 99.8
从电子表格创建一个表,其中包含第一行中的变量名和第一列中的行名。
T =可读的(“patients.xls”,“ReadRowNames”,真正的);
显示表的前五行和前四个变量。
T (1:5, 1:4)
ans =5×4表性别年龄位置高度 __________ ___ _____________________________ ______ 史密斯{‘男性’}38{县综合医院的}71年约翰逊43{‘男性’}{VA医院的}69年威廉姆斯{‘女性’}38{圣。玛丽医疗中心64琼斯{'女' 40{'弗吉尼亚州医院' 67布朗{'女' 49{'县总医院' 64
查看DimensionNames属性。
DimensionNames
T.Properties.DimensionNames
ans =1 x2单元格{' LastName}{}“变量”
“姓”是电子表格第一行的第一列中的名称。
“姓”
使用电子表格指定区域的数据创建一个表patients.xls.使用角之间5乘3的矩形区域的数据C2而且E6.不要使用该区域的第一行作为变量名。
patients.xls
C2
E6
T =可读的(“patients.xls”,...“范围”,“C2: E6”,...“ReadVariableNames”假)
T = Var1 Var2 Var3 ____ ___________________________ ____ 38 '县总医院' 71 43 'VA医院' 69 38 '圣玛丽医疗中心' 64 40 'VA医院' 67 49 '县总医院' 64
T包含默认变量名。
创建导入选项,为多个变量定制数据类型,然后读取数据。
从文本文件创建一个导入选项对象。
opts = detectImportOptions(“airlinesmall.csv”)
属性:Format属性:Delimiter:{','}空白:'\b\t ' LineEnding: {'\n' '\r' '\r\n'} CommentStyle: {} ConsecutiveDelimitersRule: 'split' LeadingDelimitersRule: 'keep' TrailingDelimitersRule: 'ignore' EmptyLineRule: 'skip'编码:' iso - 8858 -1'替换属性:MissingRule: 'fill' ImportErrorRule: 'fill' ExtraColumnsRule: 'addvars'变量导入属性:使用setvartype VariableNames按名称设置类型:{'年','月','月之日'…{'double', 'double', 'double'…{'年','月','月之日'…使用setvaropts/getvaropts VariableNamingRule: 'modify' Location Properties: DataLines: [2 Inf] VariableNamesLine: 1 RowNamesColumn: 0 VariableUnitsLine: 0 VariableDescriptionsLine: 0要显示表的预览,使用preview
检查类型变量的属性TaxiIn而且TaxiOut.
类型
TaxiIn
TaxiOut
getvaropts(选择,{“TaxiIn”,“TaxiOut”})
ans = 1x2 TextVariableImportOptions数组的属性:名称类型FillValue TreatAsMissing QuoteRule前缀后缀EmptyFieldRule WhitespaceRule
更改变量的类型TaxiIn而且TaxiOut来双.
Opts = setvartype(Opts,{“TaxiIn”,“TaxiOut”},“双”);
指定要导入和检查的变量子集。
选择。SelectedVariableNames = {“TaxiIn”,“TaxiOut”};
使用readtable函数和options对象一起导入所选变量。显示表的摘要。
T =可读的(“airlinesmall.csv”、选择);总结(T)
变量:TaxiIn: 123523x1 double值:Min 0中位数5 Max 1451 NumMissing 37383 TaxiOut: 123523x1 double值:Min 0中位数13 Max 755 NumMissing 37364
检测电子表格文件的导入选项,指定要导入的变量,然后读取数据。
从文件创建一个导入选项对象。
opts = detectImportOptions(“patients.xls”)
替换属性:MissingRule: '填充' ImportErrorRule: '填充'变量导入属性:使用setvartype VariableNames按名称设置类型:{'LastName', 'Gender', 'Age'…{'char', 'char', 'double'…{'LastName', 'Gender', 'Age'…使用setvaropts/getvaropts VariableNamingRule: 'modify' Range Properties: DataRange: 'A2'(开始单元格)VariableNamesRange: 'A1' RowNamesRange: " VariableUnitsRange: " VariableDescriptionsRange: "要显示表的预览,使用preview
修改options对象以指定要导入的变量。
选择。SelectedVariableNames = {“收缩”,舒张压的};
使用readtable与options对象一起导入指定的变量。
T =可读的(“patients.xls”、选择);总结(T)
变量:收缩压:100x1双值:最小109中位数122最大138舒张压:100x1双值:最小68中位数81.5最大99
您可以读取表格数据,同时保留包含任何字符(包括空格和非ascii字符)的变量名。首先,创建一个具有任意变量名的表,并将该表写入文本文件。然后,在保留原始变量名的同时,将表格数据读回。
创建一个包含任意变量名的表,并将表格数据写入文件“sampletable.txt”.
“sampletable.txt”
LastName = {“桑切斯”;“约翰逊”;“李”;“Diaz”;“棕色”};年龄= [38;43;38;40;49];吸烟者=逻辑([1;0;1;0;1]);varNames = {“姓”,“年龄”,“吸烟者(1或0)”};T =表(姓氏,年龄,吸烟者,“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”参数保存.
“吸烟者(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 x而且0 b前缀。数值使用整数数据类型存储。当这些数字没有前缀时,还可以使用导入选项读取它们。
0 x
0 b
预览hexAndBinary.txt在文本编辑器中归档。它有带前缀的十六进制和二进制数列,还有一列没有前缀。
hexAndBinary.txt
使用readtable.该函数检测与的数字0 x而且0 b前缀并将它们存储为整数。第三列没有前缀,因此它的值被视为文本。
T =可读的(“hexAndBinary.txt”)
T =3×4表Var1 Var2 Var3 Var4 _____ ____ ________ ___________ 255 255{‘C7F9}{‘Device1} 256年4{05男朋友'}{‘Device2} 43981 129{‘F00F} {' Device3 '}
的readtable函数将数值存储在不同的整数类(uint16而且uint8),因为T.Var1具有需要8位以上存储空间的值。
uint16
uint8
T.Var1
类(T.Var1)
Ans = 'uint16'
类(T.Var2)
Ans = 'uint8'
若要指定存储从十六进制和二进制数导入的数值的数据类型,请使用“HexType”而且“BinaryType”名称-值对参数。将值存储为带符号的32位整数。
“HexType”
“BinaryType”
T =可读的(“hexAndBinary.txt”,“HexType”,“int32”,“BinaryType”,“int32”);类(T.Var1)
Ans = 'int32'
您可以使用导入选项来检测没有前缀的十六进制和二进制数,并为它们指定存储空间。创建一个导入选项对象hexAndBinary.txt.
opts = detectImportOptions(“hexAndBinary.txt”)
属性:Format属性:Delimiter:{','}空白:'\b\t ' LineEnding: {'\n' '\r' '\r\n'} CommentStyle: {} ConsecutiveDelimitersRule: 'split' LeadingDelimitersRule: 'keep' TrailingDelimitersRule: '忽略' EmptyLineRule: 'skip'编码:'UTF-8'替换属性:MissingRule: 'fill' ImportErrorRule: 'fill' ExtraColumnsRule: 'addvars'变量导入属性:使用setvartype VariableNames按名称设置类型:{'Var1', 'Var2', 'Var3'…{'auto', 'auto', 'char'…{'Var1', 'Var2', 'Var3'…使用setvaropts/getvaropts VariableNamingRule: 'modify' Location Properties: DataLines: [1 Inf] VariableNamesLine: 0 RowNamesColumn: 0 VariableUnitsLine: 0 VariableDescriptionsLine: 0要显示表的预览,使用preview
要指定第三列作为十六进制值导入,尽管没有前缀,请使用setvaropts函数修改表中第三个变量的变量类型。将变量类型设置为int32.
setvaropts
int32
Opts = setvaropts(Opts,3,“NumberSystem”,十六进制的,“类型”,“int32”)
属性:Format属性:Delimiter:{','}空白:'\b\t ' LineEnding: {'\n' '\r' '\r\n'} CommentStyle: {} ConsecutiveDelimitersRule: 'split' LeadingDelimitersRule: 'keep' TrailingDelimitersRule: '忽略' EmptyLineRule: 'skip'编码:'UTF-8'替换属性:MissingRule: 'fill' ImportErrorRule: 'fill' ExtraColumnsRule: 'addvars'变量导入属性:使用setvartype VariableNames按名称设置类型:{'Var1', 'Var2', 'Var3'…{'auto', 'auto', 'int32'…{'Var1', 'Var2', 'Var3'…使用setvaropts/getvaropts VariableNamingRule: 'modify' Location Properties: DataLines: [1 Inf] VariableNamesLine: 0 RowNamesColumn: 0 VariableUnitsLine: 0 VariableDescriptionsLine: 0要显示表的预览,使用preview
读取文件并将第三列作为数值导入,而不是文本。
T =可读的(“hexAndBinary.txt”选择)
T =3×4表Var1 Var2 Var3 Var4 _________ _____ ___________ 255 255 51193 {'Device1'} 256 4 1471 {'Device2'} 43981 129 61455 {'Device3'}
为XML文件创建XML导入选项,指定要导入的变量,然后读取数据。
XML文件students.xml是否命名了四个兄弟节点学生,每个都包含相同的子节点和属性。
students.xml
学生
类型students.xml
<?XML版本="1.0"编码="utf-8"?> <学生> <学生ID="S11305"> <名字FirstName="Priya" LastName="Thompson" /> <年龄>18年龄> <年级>新生年级> <地址> <街道xmlns="//www.tianjin-qmedu.com/la/">591 Spring Lane街道> <城市>Natick城市>MA城市> 城市> <主修>计算机科学主要> <辅修>英语文学辅修> <学生ID="S23451"> 18年龄> <年级>新生年级> <地址> <街道xmlns="//www.tianjin-qmedu.com/la/">4641 Pearl Street街道>San Francisco CA Microbiology Public Health 21 Senior 30 Highland Road Detriot MI Political Science 19 Sophomore 3388 Moore Avenue Fort Worth TX Business Japanese Language 20 Sophomore 3388 Moore Avenue Fort Worth TX Business Japanese Language 22 Senior 22 Angie Drive Los Angeles CA Mechanical Engineering Architecture 21 Junior 65 Decatur Lane Trenton ME Economics Art History
创建一个XMLImportOptions对象。指定的值VariableSelectors作为/ / @FirstName选择FirstName元素节点作为表变量导入。
XMLImportOptions
VariableSelectors
/ / @FirstName
FirstName
opts = xmlImportOptions(“VariableSelectors”," / / @FirstName”)
替换属性:MissingRule: "fill" ImportErrorRule: "fill" RepeatedNodeRule: "addcol"变量导入属性:通过名称设置类型使用setvartype VariableNames: "Var1" VariableTypes: "char" SelectedVariableNames: "Var1" VariableOptions:显示所有1个VariableOptions访问VariableOptions子属性使用setvaropts/getvaropts VariableNamingRule: "preserve" Location属性:TableSelector: RowSelector: variableelectors: "//@FirstName" VariableUnitsSelector: VariableDescriptionsSelector: RowNamesSelector: RegisteredNamespaces: [0x2 string]
T =可读的(“students.xml”选择)
T =7×1表Var1 __________ {' Priya’}{康纳的}{“摩根”}{萨利姆的}{萨利姆的}{“达尼亚”}{' Rikki '}
方法将自定义XML名称空间前缀注册到输入文件中的现有名称空间URLRegisteredNamespaces名称-值参数。
RegisteredNamespaces
创建一个XMLImportOptions对象从XML文件。属性的XPath表达式街元素节点的值“VariableSelectors”,并注册前缀myPrefix的URL街节点。
街
“VariableSelectors”
myPrefix
opts = detectImportOptions(“students.xml”,“RegisteredNamespaces”, (“myPrefix”,“//www.tianjin-qmedu.com”),...“VariableSelectors”," / / myPrefix:街”)
替换属性:MissingRule: "fill" ImportErrorRule: "fill" RepeatedNodeRule: "addcol"变量导入属性:通过名称设置类型使用setvartype VariableNames: "Street" VariableTypes: "string" SelectedVariableNames: "Street" VariableOptions:显示所有1个VariableOptions访问VariableOptions子属性使用setvaropts/getvaropts VariableNamingRule: "preserve" Location属性:TableSelector: RowSelector: variableelectors: "//myPrefix:Street" VariableUnitsSelector: VariableDescriptionsSelector: RowNamesSelector: RegisteredNamespaces: ["myPrefix" "//www.tianjin-qmedu.com/la/"]
使用readtable函数和options对象一起导入所选变量。
T2 =可读(“students.xml”选择)
T2 =7×1表街道___________________“春巷591号”“珍珠街4641号”“高地道30号”“摩尔大道3388号”“摩尔大道3388号”“安济道22号”“迪凯特里65号”
的readtable函数在默认情况下从Microsoft Word文档文件读取第一个表。该文件MaintenanceReport.docx包含两个表。第二个表的最后一行包含一个单元格,其中合并的列与表变量不匹配。
MaintenanceReport.docx
的方法读取第二个表TableIndex选项2.若要跳过包含合并列的单元格的行,请设置MergedCellColumnRule选项“omitrow”.
TableIndex
2
MergedCellColumnRule
“omitrow”
文件名=“MaintenanceReport.docx”;T = readtable(文件名,“TableIndex”,2,“MergedCellColumnRule”,“omitrow”)
T =3×5表类别描述紧急解决成本 _____________________________________________________________________ ____________________ ________ __________________ ________ " 项目是偶尔陷入扫描仪卷。”“机械故障”“中等”“重新调整机器”“45美元”“组装活塞发出的嘎嘎声和砰砰声。”“机械故障”“中等”“重新调整机器”“35美元”“启动工厂时电源中断。”“电子故障”“高”“全更换”“$16200”
方法使用XPath选择器选择表TableSelector选择。要选择包含文本“Description”的Microsoft Word文档表,请使用XPath选择器" / / w:资源描述(包含(“描述”))”.
TableSelector
" / / w:资源描述(包含(“描述”))”
T = readtable(文件名,...“TableSelector”," / / w:资源描述(包含(“描述”))”,...“MergedCellColumnRule”,“omitrow”)
从URL读取第一个表//www.tianjin-qmedu.com/help/matlab/text-files.html包含文本的“readtable”使用XPath选择器" / /表(包含(“readtable”)]”.表没有标题行,因此设置ReadVariableNames选项假.
“readtable”
" / /表(包含(“readtable”)]”
假
url =“//www.tianjin-qmedu.com/help/matlab/text-files.html”;T = readtable(url,“TableSelector”," / /表(包含(“readtable”)]”,...“ReadVariableNames”假)
T =4×2表Var1 Var2 ________________ ____________________________ "可读" "从文件中创建表" "可写" "将表写入文件" " read时间表" "从文件中创建时间表" " write时间表" "将时间表写入文件"
要读取的文件名,指定为字符向量或字符串标量。
这取决于你文件的位置,文件名可以变成这些形式之一。
位置
形式
中指定文件的名称文件名.
例子:“myFile.txt”
“myFile.txt”
文件夹中的文件
如果文件不在当前文件夹或MATLAB路径上的文件夹中,则在中指定完整或相对路径名文件名.
例子:“C: \ myFolder \ myFile.xlsx”
“C: \ myFolder \ myFile.xlsx”
例子:“dataDir \ myFile.txt”
“dataDir \ myFile.txt”
如果文件指定为internet统一资源定位符(URL),则文件名必须包含协议类型“http://”或“https://”.
“http://”
“https://”
例子:“http://hostname/path_to_file/my_data.csv”
“http://hostname/path_to_file/my_data.csv”
远程位置
如果文件存储在远程位置,则文件名必须包含用表单指定的文件的完整路径:
scheme_name://path_to_file/my_file.ext
scheme_name
path_to_file
my_file.ext
根据地点偏远,scheme_name可以是该表中的一个值。
s3
wasb
wasbs
hdfs
有关更多信息,请参见使用远程数据.
例子:s3: / / bucketname / path_to_file / my_file.csv '
s3: / / bucketname / path_to_file / my_file.csv '
如果文件名包含文件扩展名,然后导入函数从扩展名确定文件格式。否则,必须指定“文件类型”名称-值对参数来指示文件的类型。
“文件类型”
在Windows上®Microsoft Excel系统®在Excel软件中,导入功能可以读取您的Excel版本所识别的任何Excel电子表格文件格式。
如果您的系统没有Windows Excel,或者您正在使用MATLAB在线™,导入函数与UseExcel属性设置为假,并只阅读.xls、.xlsx、.xlsm、.xltx和.xltm文件。
.xls、.xlsx、.xlsm、.xltx和.xltm
对于带分隔符的文本文件,导入函数将文件中的空字段转换为两者之一南(对于数值变量)或空字符向量(对于文本变量)。文本文件中的所有行必须具有相同数量的分隔符。导入函数忽略文件中不重要的空白。
数据类型:字符|字符串
字符
字符串
SpreadsheetImportOptions
DelimitedtextImportOptions
FixedWidthImportOptions
WordDocumentImportOptions
HTMLDocumentImportOptions
文件导入选项指定为SpreadsheetImportOptions,DelimitedTextImportOptions,FixedWidthImportOptions,XMLImportOptions,WordDocumentImportOptions,或HTMLDocumentImportOptions对象创建的detectImportOptions函数。的选择对象包含控制数据导入过程的属性。有关每个对象属性的更多信息,请参阅相应的对象页面。
DelimitedTextImportOptions
DataRange
VariableNames
HTMLImportOptions
指定可选参数对为Name1 = Value1,…,以=家,在那里的名字参数名称和价值对应的值。名-值参数必须出现在其他参数之后,但对的顺序并不重要。
Name1 = Value1,…,以=家
的名字
价值
在R2021a之前,名称和值之间用逗号隔开,并括起来的名字在报价。
例子:“ReadVariableNames”,假的指示文件的第一行与变量名不对应。
“ReadVariableNames”,假的
文件类型
“表格”
“文本”
“delimitedtext”
“fixedwidth”
“xml”
“worddocument”
“html”
文件类型,指定为逗号分隔的对,由“文件类型”其中一个值。
DelimitedTextImportOptions或FixedWidthImportOptions取决于文本文件的布局。
DelimitedTextImportOptions,对于列由分隔符分隔的文本文件使用此选项。
FixedWidthImportOptions,对于列宽度固定的文本文件使用此选项。
XMLImportOptions,对XML文件使用此选项。
WordDocumentImportOptions,使用此选项微软文字处理软件文档文件。
HTMLImportOptions,对HTML文件使用此选项。
使用“文件类型”时名称-值对参数文件名不包括文件扩展名,或者当扩展名不是以下之一时:
. txt,.dat,或. csv对于文本文件
. xml,用于XML文件
。docx为微软文字处理软件文档文件
. html,名为. xhtml的,或. htmfor HTML文件
例子:“文件类型”、“文本”
“文件类型”、“文本”
真正的
0
1
指示器,用于将第一列读取为行名,指定为逗号分隔的对,由“ReadRowNames”,要么假,真正的,0,或1.
“ReadRowNames”
指示器
描述
当要读取的区域的第一列包含数据,而不是表的行名时使用。
当要读取的区域的第一列包含表的行名时使用。
注意:如果两者都“ReadVariableNames”而且“ReadRowNames”逻辑指示符为真正的,然后readtable将区域第一行第一列中的名称保存为属性中的第一个维度名称,T.Properties.DimensionNames.
“ReadVariableNames”
如果指定ReadRowNames除…外选择导入选项,然后readtable基于规范的行为变化:
如果ReadRowNames是真正的方法从指定文件中读取行名RowNamesRange或者是RowNameColumn属性的导入选项对象。
RowNamesRange
RowNameColumn
如果ReadRowNames是假,则不导入行名。
例子:“ReadRowNames”,真的
“ReadRowNames”,真的
分隔符
字段分隔符字符,指定为逗号分隔对,由“分隔符”一个字符向量,一个字符向量的单元格数组,或者一个字符串。指定分隔符使用任何有效字符,如逗号”、“或者一个周期“。”.
“分隔符”
”、“
“。”
该表列出了一些常用的字段分隔符。
说明符
字段分隔符
“逗号”
逗号
' '
“空间”
空间
' \ t '
“标签”
选项卡
“;”
“半”
分号
“|”
“酒吧”
竖线
如果未指定的,readtable自动检测分隔符。
若要将连续分隔符视为单个分隔符,请指定分隔符作为字符向量的单元格数组。此外,还必须指定MultipleDelimsAsOne选择。
MultipleDelimsAsOne
例子:“分隔符”、“,”或“分隔符”、“逗号”
“分隔符”、“,”
“分隔符”、“逗号”
数据类型:字符|字符串|细胞
细胞
LeadingDelimitersRule
“保持”
“忽略”
“错误”
过程来管理分隔文本文件中的前导分隔符,指定为此表中的值之一。
例子:“LeadingDelimitersRule”,“保持”
“LeadingDelimitersRule”,“保持”
TrailingDelimitersRule
过程来管理分隔文本文件中的尾随分隔符,指定为此表中的值之一。
例子:“TrailingDelimitersRule”,“保持”
“TrailingDelimitersRule”,“保持”
ConsecutiveDelimitersRule
“分裂”
“加入”
过程处理分隔文本文件中的连续分隔符,指定为此表中的值之一。
例子:“ConsecutiveDelimitersRule”、“分裂”
“ConsecutiveDelimitersRule”、“分裂”
0(假)
1(真正的)
多个分隔符处理,指定为逗号分隔的对,由“MultipleDelimsAsOne”,要么真正的或假.如果真正的,则导入函数将连续的分隔符视为单个分隔符。由空格分隔的重复分隔符也被视为单个分隔符。还必须指定分隔符选择。
“MultipleDelimsAsOne”
例子:“MultipleDelimsAsOne”,1
“MultipleDelimsAsOne”,1
NumHeaderLines
在文件开始时要跳过的标题行数,指定为逗号分隔的对,由“NumHeaderLines”一个正整数。如果未指定的,readtable自动检测要跳过的行数。
“NumHeaderLines”
例子:“NumHeaderLines”,2
“NumHeaderLines”,2
数据类型:单|双
单
TreatAsMissing
作为空值处理的占位符文本,指定为逗号分隔的对,由“TreatAsMissing”以及字符向量,字符向量的单元格数组,字符串,或字符串数组。与这些字符对应的表元素被设置为南.
“TreatAsMissing”
“TreatAsMissing”只适用于表中的数字列,并且readtable不接受数字文字,例如“-99”.
“-99”
例子:“TreatAsMissing”、“N / A”或“TreatAsMissing”、“N / A”集N/A在数值列内南.
“TreatAsMissing”、“N / A”
N/A
例子:TreatAsMissing,{“。”,“NA”、“N / A”}或“TreatAsMissing”,(“。”,“NA”、“N / A”)集.,NA而且N/A在数值列内南.
TreatAsMissing,{“。”,“NA”、“N / A”}
“TreatAsMissing”,(“。”,“NA”、“N / A”)
.
NA
MissingRule
“填满”
“omitvar”
过程来管理丢失的数据,指定为此表中的值之一。
类的内容替换缺失的数据FillValue财产。
FillValue
的FillValue属性中指定的VariableImportOptions对象的值。有关访问的更多信息FillValue财产,看到getvaropts.
VariableImportOptions
getvaropts
例子:“MissingRule”、“omitrow”
“MissingRule”、“omitrow”
TextType
“字符”
“字符串”
类型,指定为逗号分隔的对,由“TextType”,要么“字符”或“字符串”.
“TextType”
“字符”-将文本数据作为字符向量导入MATLAB。
“字符串”-将文本数据作为字符串数组导入MATLAB。
例子:“TextType”、“生物炭”
“TextType”、“生物炭”
DatetimeType
“datetime”
“exceldatenum”
导入的日期和时间数据的类型,指定为逗号分隔的对,由“DatetimeType”其中一个价值观是:“datetime”,“文本”,或“exceldatenum”.的值“exceldatenum”仅适用于电子表格文件,而不适用于文本文件。
“DatetimeType”
MATLABdatetime数据类型
datetime
有关更多信息,请参见datetime.
如果“DatetimeType”指定为“文本”中指定的值,则导入的日期和时间数据的类型取决于“TextType”参数:
如果“TextType”设置为“字符”,那么导入函数将以字符向量的单元格数组形式返回日期。
如果“TextType”设置为“字符串”,那么导入函数将以字符串数组的形式返回日期。
Excel序列号
流水号是一个单独的数字,等于从给定的参考日期开始的天数。Excel系列日期号使用与MATLAB系列日期号不同的参考日期。有关Excel日期的更多信息,请参见https://万博1manbetxsupport.microsoft.com/en-us/kb/214330.
https://万博1manbetxsupport.microsoft.com/en-us/kb/214330
例子:“DatetimeType”、“日期时间的
“DatetimeType”、“日期时间的
VariableNamingRule
“修改”
“保存”
标记以保留变量名,指定为任意“修改”或“保存”.
“修改”转换无效的变量名(由isvarname函数)到有效的MATLAB标识符。
isvarname
“保存”-保留不是有效的MATLAB标识符的变量名,例如包含空格和非ascii字符的变量名。
从R2019b开始,变量名和行名可以包含任何字符,包括空格和非ascii字符。此外,它们可以以任何字符开头,而不仅仅是字母。变量名和行名不一定是有效的MATLAB标识符(由isvarname功能)。若要保留这些变量名和行名,请设置的值VariableNamingRule来“保存”.的值时不会刷新变量名VariableNamingRule更改为“修改”来“保存”.
例子:“VariableNamingRule”、“保存”
“VariableNamingRule”、“保存”
ImportErrorRule
过程处理导入错误,指定为此表中的值之一。
类的内容替换发生错误的数据FillValue财产。
例子:“ImportErrorRule”、“omitvar”
“ImportErrorRule”、“omitvar”
WebOptions
HTTP
HTTPS
weboptions
HTTP或HTTPS请求选项,指定为weboptions对象。的weboptions对象确定在指定时如何导入数据文件名是否包含该协议类型的internet URL“http://”或“https://”.
指示器,用于将第一行读取为变量名,指定为逗号分隔的对,由“ReadVariableNames”,要么真正的,假,1,或0.如果未指定的,readtable自动检测变量名的存在。
当要读取的区域的第一行包含表的变量名时使用。readtable中的每列创建一个变量,使用检测到的变量名T.
当要读取的区域的第一行包含表中的数据时使用。readtable创建表单的默认变量名“Var1”,…,“VarN”,在那里N是变量的个数。
“Var1”,…,“VarN”
N
如果指定ReadVariableNames除…外选择导入选项,然后readtable基于规范的行为变化:
如果ReadVariableNames是真正的方法从指定文件中读取变量名VariableNamesRange或者是VariableNamesLine属性的导入选项对象。
VariableNamesRange
VariableNamesLine
如果ReadVariableNames是假,然后从VariableNames属性的导入选项对象。
例子:“ReadVariableNames”,真的
“ReadVariableNames”,真的
ExpectedNumVariables
变量的期望数目,指定为逗号分隔的对,由“ExpectedNumVariables”一个正整数。如果未指定,导入函数将自动检测变量的数量。
“ExpectedNumVariables”
例子:“ExpectedNumVariables”,5
“ExpectedNumVariables”,5
VariableWidths
固定宽度文本文件中变量的字段宽度,指定为正整数值的向量。向量中的每个正整数对应于组成变量的字段中的字符数。的VariableWidths属性中指定的每个变量对应的项VariableNames财产。
例子:“VariableWidths”,[7]10、7、4、26日
“VariableWidths”,[7]10、7、4、26日
空格
作为空白处理的字符,指定为包含一个或多个字符的字符向量或字符串标量。
例子:“空白”、“_”
“空白”、“_”
例子:“空白”、“? !”
“空白”、“? !”
EmptyLineRule
“跳过”
“读”
过程来处理数据中的空行,指定为“跳过”,“读”,或“错误”.导入函数将空白解释为空。
VariableOptions
例子:“EmptyLineRule”,“跳过”
“EmptyLineRule”,“跳过”
变量名称位置,指定为正标量整数。的VariableNamesLine属性指定变量名所在的行号。
如果VariableNamesLine指定为0,则不导入变量名。否则,从指定的行导入变量名。
例子:“VariableNamesLine”6
“VariableNamesLine”6
数据类型:单|双|uint8|uint16|uint32|uint64
uint64
PartialFieldRule
“包装”
过程来处理数据中的部分字段,指定为此表中的值之一。
保留部分字段数据并将文本转换为适当的数据类型。
在某些情况下,当导入函数无法解释部分数据时,可能会发生转换错误。
例子:“PartialFieldRule”,“保持”
“PartialFieldRule”,“保持”
VariableUnitsLine
变量单元位置,指定为正标量整数。的VariableUnitsLine属性指定变量单元所在的行号。
如果VariableUnitsLine指定为0,则不导入变量单元。否则,从指定的行导入变量单元。
例子:“VariableUnitsLine”,8
“VariableUnitsLine”,8
VariableDescriptionsLine
变量说明位置,指定为正标量整数。的VariableDescriptionsLine属性指定变量描述所在的行号。
如果VariableDescriptionsLine指定为0,则不导入变量描述。否则,从指定的行导入变量描述。
例子:“VariableDescriptionsLine”7
“VariableDescriptionsLine”7
ExtraColumnsRule
“addvars”
过程处理数据中的额外列,指定为此表中的值之一。
要导入额外的列,请创建新变量。如果有N额外的列,然后导入新变量为“ExtraVar1”、“ExtraVar2’,……、“ExtraVarN”.
“ExtraVar1”、“ExtraVar2’,……、“ExtraVarN”
注意:额外的列作为具有数据类型的文本导入字符.
例子:“ExtraColumnsRule”、“addvars”
“ExtraColumnsRule”、“addvars”
格式
“汽车”
文件的列格式,指定为逗号分隔的由“格式”和具有一个或多个转换说明符的字符向量或字符串标量“汽车”.转换说明符与类所接受的说明符相同textscan函数。
“格式”
textscan
指定格式可以显著提高某些大型文件的速度。如果不指定的值格式,然后readtable使用%问解释非数字列。的%问说明符读取文本并省略双引号(")。
%问
"
如果不指定“格式”名称-值对,然后readtable函数的行为就好像您使用了detectImportOptions函数导入数据。有关此行为后果的更多信息,请参见兼容性的考虑.
如果你指定“格式”、“汽车”,则创建的变量为双数组,字符向量的单元格数组,或datetime数组,取决于数据。如果整个列是数值型的,则将变量导入为双.如果列中的任何元素不是数值型的,则将变量作为字符向量的单元格数组导入,或者作为datetime数组,如果值表示日期和时间。
例子:“格式”、“汽车”
EmptyValue
分隔文本文件中空数值字段的返回值,指定为逗号分隔的对,由“EmptyValue”和一个数值标量。
“EmptyValue”
例子:“EmptyValue”,0
“EmptyValue”,0
CollectOutput
确定数据连接的逻辑指示符,指定为逗号分隔的对,由“CollectOutput”,要么真正的或假.如果真正的,则导入函数将同一基本MATLAB类的连续输出单元连接到一个数组中。
“CollectOutput”
例子:“CollectOutput”,真的
“CollectOutput”,真的
CommentStyle
表示要忽略的文本的符号,指定为逗号分隔的一对,由“CommentStyle”以及字符向量,字符向量的单元格数组,字符串,或字符串数组。
“CommentStyle”
例如,指定一个字符,例如“%”忽略同一行符号后面的文本。指定包含两个字符向量的单元格数组,例如{'/*','*/'},以忽略这些序列之间的任何文本。
“%”
{'/*','*/'}
MATLAB只在每个字段的开头检查注释,而不是在字段内部。
例子:“CommentStyle ',{'/*','*/'}
“CommentStyle ',{'/*','*/'}
ExponentCharacter
“eEdD”
指数字符,指定为逗号分隔的一对,由“ExponentCharacter”和一个字符向量或字符串。默认的指数字符为e,E,d,D.
“ExponentCharacter”
e
E
d
D
例子:“ExponentCharacter”、“eE”
“ExponentCharacter”、“eE”
LineEnding
行结束字符,指定为逗号分隔的对,由“LineEnding”和一个字符向量或字符串。字符向量必须是“\ r \ n”或者它必须指定单个字符。常用的行尾字符是换行符(' \ n ')或乘马车返回(' \ r ').如果你指定“\ r \ n”,则导入函数处理任意r \,\ n,以及两者的组合(\ r \ n)作为行尾字符。
“LineEnding”
“\ r \ n”
' \ n '
' \ r '
r \
\ n
\ r \ n
默认的行尾序列为\ n,r \,或\ r \ n,这取决于文件的内容。
如果文件中最后一行末尾缺少值和行尾序列,则导入函数将为这些字段返回空值。这确保了输出单元格数组中的单个单元格,C,尺寸相同。
C
例子:‘LineEnding’,‘:’
‘LineEnding’,‘:’
用于读取日期的地区,指定为逗号分隔的对,由“DateLocale”和该形式的字符向量或字符串标量xx_YY,地点:
“DateLocale”
xx_YY
xx
YY
YY是一个大写的ISO 3166-1 alpha-2代码,表示一个国家。
xx是ISO 639-1两个字母的小写代码,表示一种语言。
此表列出了区域设置的一些通用值。
“de_DE”
“en_GB”
“en_US”
“es_ES”
“fr_FR”
“it_IT”
“ja_JP”
“ko_KR”
“设置nl_NL”
“zh_CN”
当使用% D将文本读取为的格式说明符datetime值,使用DateLocale指定导入函数应该解释月份和星期的名称和缩写的语言环境。
如果指定DateLocale除…外选择的导入选项,则导入函数将使用指定的值DateLocale参数,覆盖在导入选项中定义的语言环境。
例子:“DateLocale”、“ja_JP”
“DateLocale”、“ja_JP”
DecimalSeparator
指示数值变量中的十进制分隔符的字符,指定为字符向量或字符串标量。文件中指定的字符DecimalSeparator名称-值对,以区分数字的整数部分和小数部分。
当转换为整数数据类型时,带有小数部分的数字将四舍五入到最接近的整数。
例子:如果名称-值对指定为“DecimalSeparator”、“,”,然后导入函数导入文本“14159”作为数字3.14159.
“DecimalSeparator”、“,”
“14159”
3.14159
ThousandsSeparator
表示数字变量中分组的千位的字符,指定为字符向量或字符串标量。成千上万的分组字符充当可视分隔符,每三个位值分组一个数字。文件中指定的字符ThousandsSeparator名称-值对来解释导入的数字。
例子:如果名称-值对指定为“ThousandsSeparator”、“,”,然后导入函数导入文本“1234000”作为1234000.
“ThousandsSeparator”、“,”
“1234000”
1234000
TrimNonNumeric
从指定为逻辑类型的数值变量中删除非数值字符真正的或假.
例子:如果名称-值对指定为“TrimNonNumeric”,真的,然后导入函数读取“500美元/ -”作为500.
“TrimNonNumeric”,真的
“500美元/ -”
500
数据类型:逻辑
逻辑
“utf - 8”
“iso - 8859 - 1”
“windows - 1251”
“windows - 1252”
与文件关联的字符编码方案,指定为逗号分隔的对,由“编码”而且“系统”或者一个标准字符编码方案名称。如果不指定任何编码,则readtable函数在读取文件时使用自动字符集检测来确定编码。
“编码”
“系统”
如果指定“编码”参数之外的导入选项,则readtable函数使用指定的值“编码”,覆盖在导入选项中定义的编码。
例子:“编码”,“utf - 8”使用UTF-8作为编码。
“编码”,“utf - 8”
例子:“编码”、“系统”使用系统默认编码。
“编码”、“系统”
DurationType
“持续时间”
文本文件的持续时间数据的输出数据类型,指定为逗号分隔的对,由“DurationType”,要么“持续时间”或“文本”.
“DurationType”
MATLAB持续时间数据类型
持续时间
有关更多信息,请参见持续时间.
如果“DurationType”指定为“文本”,则导入的持续时间数据的类型取决于“TextType”参数:
如果“TextType”是“字符”,那么导入函数将以字符向量的单元格数组形式返回持续时间数据。
如果“TextType”是“字符串”,那么导入函数将以字符串数组的形式返回持续时间数据。
例子:“DurationType”、“文本”
“DurationType”、“文本”
HexType
“int8”
“int16”
输出数据类型的十六进制数据,指定为逗号分隔的对组成“HexType”和表中列出的值之一。
输入文件将十六进制值表示为文本,使用任意一种0 x或0 x作为前缀和字符0-9,一个-f,一个-F作为数字。(大写字母和小写字母代表相同的数字,例如,“0 xf”而且“0 xf”两个代表15.)
9
一个
f
F
“0 xf”
15
导入函数将十六进制值转换为值指定的数据类型“HexType”.
的价值“HexType”
输出表变量的数据类型
自动检测到的数据类型
未修改的输入文本
8位整数,带符号
16位整数,带符号
“int32”
32位整数,带符号
“int64”
64位整数,有符号
“uint8”
8位整数,无符号
“uint16”
16位整数,无符号
“uint32”
32位整数,无符号
“uint64”
64位整数,无符号
例子:“HexType”、“uint16”转换表示十六进制值的文本(例如“0 xff”)转换为无符号的16位整数(例如255)。
“HexType”、“uint16”
“0 xff”
255
BinaryType
输出数据类型的二进制数据,指定为逗号分隔的对组成“BinaryType”和表中列出的值之一。
输入文件将二进制值表示为文本,使用任意一种0 b或0 b作为前缀和字符0而且1作为数字。
导入函数将二进制值转换为值指定的数据类型“BinaryType”.
的价值“BinaryType”
例子:“BinaryType”、“uint16”转换表示二进制值的文本(如“0 b11111111”)转换为无符号的16位整数(例如255)。
“BinaryType”、“uint16”
“0 b11111111”
范围
要读取的工作表的一部分,表示为由逗号分隔的对指定的矩形区域“范围”和以下列形式之一表示的字符向量或字符串标量。
“范围”
“细胞”或(行坳)
“细胞”
(行坳)
从细胞
将数据的起始单元格指定为字符向量或字符串标量或两个元素的数值向量。
使用Excel包含列字母和行号的字符向量或字符串标量A1符号。例如,A5单元格的标识符是否位于列的交点处一个和行5.
A1
A5
5
两元数值向量的形式(行坳)指示起始行和列。
通过使用开始单元格,导入函数从开始单元格开始导入,并在最后一个空行或页脚范围结束,从而自动检测数据的范围。
例子:的A5或(5 - 1)
的A5
(5 - 1)
'Corner1: Corner2'
Corner1: Corner2
矩形范围
使用语法指定范围'Corner1: Corner2',在那里Corner1而且Corner2是定义这个区域的两个相对的角。例如,“D2: H4”表示两个角之间的3 × 5矩形区域D2而且H4在工作表上。的“范围”名称-值对参数不区分大小写,并使用Excel A1引用样式(参见Excel帮助)。
Corner1
Corner2
“D2: H4”
D2
H4
例子:“范围”、“D2: H4
“范围”、“D2: H4
”
未指定或为空
如果未指定的,readtable自动检测使用范围。
例子:“范围”,“
“范围”,“
注意:使用范围引用电子表格中实际包含数据的矩形部分。readtable通过修剪不包含数据的任何前行和后行和列,自动检测使用的范围。只有空白的文本被认为是数据,并在使用的范围内捕获。
'第一行:Row2'
第一行:Row2
行范围
可以通过使用Excel行指示符指定开始行和结束行来标识范围。然后readtable自动检测指定行的所用列范围。例如,readtable解释范围规范“1:7”作为读取第1行到第7行(包括)所用范围内所有列的指令。
“1:7”
例子:“范围”、“1:7的
“范围”、“1:7的
'Column1: Column2'
Column1: Column2
列范围
可以通过使用Excel列指示符指定开始列和结束列来标识范围。然后readtable自动检测指定列内使用的行范围。例如,readtable解释范围规范“答:F”作为读取A到F列中所用范围内的所有行(包括)的指令。
“答:F”
例子:“范围”、“答:F '
“范围”、“答:F '
'NamedRange'
NamedRange
Excel中的命名范围
在Excel中,您可以创建名称来标识电子表格中的范围。例如,您可以选择电子表格的一个矩形部分并调用它“myTable”.如果这样的命名范围存在于电子表格中,那么readtable可以通过名称读取该范围。
“myTable”
例子:“范围”、“myTable”
“范围”、“myTable”
例子:“范围”,A1: F10的
A1: F10的
例子:“范围”,“A1: F10”- - - - - -
“A1: F10”
要导入的数据的位置,指定为字符向量、字符串标量、字符向量的单元格数组、字符串数组、正标量整数或N——- - - - - -2正标量整数数组。指定DataRange使用这些形式之一。
“细胞”或n
n
起始单元格或起始行
使用Excel指定数据的起始单元格A1符号。例如,A5单元格的标识符是否位于列的交点处一个和行5.
通过使用开始单元格,导入函数通过从开始单元格开始导入并在最后一个空行或页脚范围结束,自动检测数据的范围。
或者,使用正标量行索引指定包含数据的第一行。
使用指定的行索引,导入函数通过从指定的第一行读取到数据末尾或页脚范围,自动检测数据的范围。
例子:的A5或5
使用矩形范围形式指定要读取的确切范围,其中Corner1而且Corner2是两个相对的角,定义了要阅读的区域。
导入函数只读取包含在指定范围内的数据。在指定范围内的任何空字段都被导入为缺失的单元格。
控件中指定的列数必须匹配NumVariables财产。
NumVariables
例子:“A5: K50”
“A5: K50”
'第一行:Row2'或'Column1: Column2'
行范围或列范围
通过使用Excel行号标识开始行和结束行来指定范围。
使用指定的行范围,导入函数通过从第一个非空列读取到数据末尾自动检测列的范围,并为每一列创建一个变量。
例子:“5:500”
“5:500”
或者,通过使用Excel列字母或数字标识开始列和结束列来指定范围。
使用指定的列范围,import函数通过从第一个非空行读取到数据末尾或页脚范围,自动检测行范围。
字段中指定的列数必须与NumVariables财产。
例子:“答:K”
“答:K”
(n1 n2;n3陶瓷;……)
多行范围
指定多个行范围用手阅读N——- - - - - -2数组包含N不同的行范围。
由多个行范围组成的有效数组必须:
按递增顺序指定行范围,即在数组中指定的第一个行范围出现在文件中其他行范围之前。
只包含不重叠的行范围。
使用正仅支持指示指定多万博1manbetx个行范围的数值数组中的最后一个范围。例如,[1 3;5 6;8正).
正
[1 3;5 6;8正)
例子:[1 3;5 6;8正)
不获取任何数据。
例子:”
例子:“DataRange”,“B2: H15”
“DataRange”
“B2: H15”
数据类型:字符|字符串|细胞|单|双
行名的位置,指定为字符向量、字符串标量、正标量整数或空字符数组。指定RowNamesRange作为该表中的一个值。
导入函数为数据中的每个变量标识一个名称。
例子:的A5
中包含的行数RowNamesRange必须匹配数据行数,并且由RowNamesRange必须只跨越一列。
例子:“A5: A50”
“A5: A50”
行名必须在单个列中。
例子:“25”
“25”
数量指标
使用正标量列索引指定包含行名的列。
例子:5
指示没有行名。
例子:“RowNamesRange”,A1: H1的
“RowNamesRange”
A1: H1的
数据类型:字符|单|双
变量名的位置,指定为字符向量、字符串标量、正标量整数或空字符数组。指定VariableNamesRange作为该表中的一个值。
导入函数为数据中的每个变量读取一个名称。
控件中指定的列数必须匹配NumVariables属性,并且范围必须只跨越一行。
例子:“A5: K5”
“A5: K5”
必须是单行。
例子:“5”
“5”
使用正标量行索引指定包含变量名的行。
指示没有变量名。
例子:“VariableNamesRange”,“A1: A15”
“VariableNamesRange”
“A1: A15”
VariableUnitsRange
变量单元的位置,指定为字符向量、字符串标量、正标量整数或空字符数组。指定VariableUnitsRange作为该表中的一个值。
导入函数为数据中的每个变量读取一个单元。
使用正标量行索引指定包含数据单元的行。
表示没有可变单位。
例子:“VariableUnitsRange”,A1: A5的
“VariableUnitsRange”
A1: A5的
数据类型:字符|字符串|单|双
VariableDescriptionsRange
变量描述的位置,指定为字符向量、字符串标量、正标量整数或空字符数组。指定VariableDescriptionRange作为该表中的一个值。
VariableDescriptionRange
导入函数读取数据中每个变量的描述。
使用正标量行索引指定包含描述的行。
指示没有变量描述。
例子:“VariableDescriptionsRange”,“B1:去往B15”
“VariableDescriptionsRange”
“B1:去往B15”
要读取的工作表,指定为逗号分隔的由“表”和指示工作表索引的正整数,或包含工作表名称的字符向量或字符串。工作表名称不能包含冒号(:).要确定电子表格文件中工作表的名称,请使用Sheets = sheetnames(filename).有关更多信息,请参见sheetnames.
“表”
:
Sheets = sheetnames(filename)
sheetnames
如果指定表除…外选择导入选项,然后readtable函数使用指定的值表参数,重写在导入选项中定义的表名称。
例子:“表”,2
例子:“表”,“MySheetName”
“MySheetName”
数据类型:字符|字符串|单|双|int8|int16|int32|int64|uint8|uint16|uint32|uint64
int8
int16
int64
的实例启动Microsoft Excel当读取电子表格数据时,指定为逗号分隔的对,由“UseExcel”,要么真正的,或假.
“UseExcel”
您可以设置“UseExcel”参数设置为以下值之一:
真正的—import函数启动一个实例Microsoft Excel读取文件时。
假—导入函数不启动实例Microsoft Excel读取文件时。在此模式下操作时,导入函数功能在支持文件格式和交互特性(如公式和宏)方面有所不同。万博1manbetx
.xls, .xlsx, .xlsm, .xltx, .xltm, .xlsb, .ods
.xls, .xlsx, .xlsm, .xltx, .xltm
万博1manbetx支持交互特性,如公式和宏
是的
没有
在从Windows平台上的电子表格文件读取时,如果想启动的实例Microsoft Excel,然后设置“UseExcel”参数真正的.
例子:“UseExcel”,真的
“UseExcel”,真的
AttributeSuffix
“属性”
属性后缀,指定为逗号分隔的对,由“AttributeSuffix”或者是字符向量或字符串标量。此参数指定读取函数附加到与输入XML文件中的属性对应的所有表变量的后缀。如果不指定“AttributeSuffix”,则read函数默认为追加后缀“属性”到输入XML文件中与属性对应的所有变量名。
“AttributeSuffix”
例子:“AttributeSuffix”、“_att”
“AttributeSuffix”、“_att”
ImportAttributes
导入属性,指定为逗号分隔的对,由“ImportAttributes”,要么1(真正的)或0(假).如果你指定假,则读取函数将不会将输入文件中的XML属性作为输出表中的变量导入。
“ImportAttributes”
例子:“ImportAttributes”,假的
“ImportAttributes”,假的
RowNodeName
表行XML节点名,指定为逗号分隔的对,由“RowNodeName”或者是字符向量或字符串标量。这个参数指定描述输出表行的XML节点名。
“RowNodeName”
例子:“RowNodeName”、“XMLNodeName”
“RowNodeName”、“XMLNodeName”
RowSelector
表行XPath表达式,指定为字符向量或字符串标量,读取函数使用它来选择输出表的各个行。您必须指定RowSelector作为有效的XPath 1.0版本表达式。
例子:“RowSelector”、“RootNode / ChildNode”
“RowSelector”、“RootNode / ChildNode”
VariableNodeNames
表变量XML节点名,指定为逗号分隔的对,由“VariableNodeNames”或者是字符向量的单元格数组或者字符串数组。这个参数指定XML节点名,读取函数使用该名称识别要在输出表中作为变量读取的XML节点。
“VariableNodeNames”
例子:VariableNodeNames,{‘XMLNodeName1’,‘XMLNodeName2}
VariableNodeNames,{‘XMLNodeName1’,‘XMLNodeName2}
例子:“VariableNodeNames”、“XMLNodeName”
“VariableNodeNames”、“XMLNodeName”
例子:“VariableNodeNames”,(“XMLNodeName1”、“XMLNodeName2”)
“VariableNodeNames”,(“XMLNodeName1”、“XMLNodeName2”)
表变量XPath表达式,指定为字符向量的单元格数组或读取函数用来选择表变量的字符串数组。您必须指定VariableSelectors作为有效的XPath 1.0版本表达式。
例子:VariableSelectors, {' / RootNode / ChildNode '}
VariableSelectors, {' / RootNode / ChildNode '}
例子:‘VariableSelectors’,”/ RootNode / ChildNode”
‘VariableSelectors’,”/ RootNode / ChildNode”
例子:“VariableSelectors”,(“/ RootNode / ChildNode1”,“/ RootNode / ChildNode2”)
“VariableSelectors”,(“/ RootNode / ChildNode1”,“/ RootNode / ChildNode2”)
TableNodeName
表XML节点名,指定为逗号分隔的对,由“TableNodeName”或者是字符向量或字符串标量。这个参数指定了读函数应该读到表的输入结构中的节点。
“TableNodeName”
例子:“TableNodeName”、“节点名的
“TableNodeName”、“节点名的
VariableUnitsSelector
变量单位XPath,指定为字符向量或字符串标量,读取函数使用它来选择表变量单位。您必须指定VariableUnitsSelector作为有效的XPath 1.0版本表达式。
例子:“VariableUnitsSelector”、“RootNode / ChildNode”
“VariableUnitsSelector”、“RootNode / ChildNode”
VariableDescriptionsSelector
变量描述XPath表达式,指定为字符向量或字符串标量,读取函数使用该表达式读取表变量描述。您必须指定VariableDescriptionsSelector作为有效的XPath 1.0版本表达式。
例子:“VariableDescriptionsSelector”、“RootNode / ChildNode”
“VariableDescriptionsSelector”、“RootNode / ChildNode”
RowNamesSelector
表行名XPath表达式,指定为字符向量或字符串标量,读取函数使用它来选择表行名。您必须指定RowNamesSelector作为有效的XPath 1.0版本表达式。
例子:“RowNamesSelector”、“RootNode / ChildNode”
“RowNamesSelector”、“RootNode / ChildNode”
RepeatedNodeRule
“addcol”
过程来处理表的给定行中重复的XML节点,指定为“addcol”,“忽略”,或“错误”.
重复节点规则
行为
在表中的变量标题下为重复的节点添加列。指定的值“RepeatedNodeRule”作为“addcol”不为重复节点在表中创建单独的变量。
“RepeatedNodeRule”
跳过导入重复的节点。
例子:“RepeatedNodeRule”、“忽略”
“RepeatedNodeRule”、“忽略”
一组注册的XML名称空间前缀,指定为逗号分隔的一对,由RegisteredNamespaces和一个前缀数组。读取函数在计算XML文件上的XPath表达式时使用这些前缀。将命名空间前缀及其关联的url指定为一个Nx2字符串数组。RegisteredNamespaces可以在计算由选择器名称-值参数指定的XPath表达式时使用,例如StructSelector为readstruct,或VariableSelectors为readtable而且readtimetable.
StructSelector
readstruct
readtimetable
默认情况下,读取函数自动检测名称空间前缀,以便注册用于XPath求值,但是您也可以使用RegisteredNamespaces名称-值参数。如果XML节点有名称空间URL,但XML文件中没有声明名称空间前缀,则可以注册一个新的名称空间前缀。
例如,计算XML文件上的XPath表达式example.xml它不包含名称空间前缀。指定“RegisteredNamespaces”作为[" myprefix ", " //www.tianjin-qmedu.com ")要分配前缀myprefix到URL//www.tianjin-qmedu.com.
example.xml
“RegisteredNamespaces”
[" myprefix ", " //www.tianjin-qmedu.com ")
myprefix
//www.tianjin-qmedu.com
T = readtable("example.xml", "VariableSelector", "/myprefix:Data",…" registrednamespaces ", ["myprefix", "//www.tianjin-qmedu.com/la/"])
例子:“RegisteredNamespaces”,(“myprefix”、“//www.tianjin-qmedu.com”)
“RegisteredNamespaces”,(“myprefix”、“//www.tianjin-qmedu.com”)
表数据XPath表达式,指定为字符向量或字符串标量,读取函数使用它来选择输出表数据。您必须指定TableSelector作为有效的XPath 1.0版本表达式。
例子:“TableSelector”、“RootNode / ChildNode”
“TableSelector”、“RootNode / ChildNode”
EmptyRowRule
规则应用于表中的空行,指定为以下之一:
“跳过”-跳过空行。
“读”—读取空行。
“错误”—在表检测和读取错误时忽略空行。
例子:“EmptyRowRule”、“读”
“EmptyRowRule”、“读”
EmptyColumnRule
规则应用于表中的空列,指定为以下之一:
“跳过”-跳过空列。
“读”-读空列。
“错误”-在表检测和读取错误时忽略空列。
例子:“EmptyColumnRule”、“错误”
“EmptyColumnRule”、“错误”
要从中读取的表的索引微软文字处理软件文档或HTML文件,包含多个表,指定为正整数。
当你指定TableIndex,软件自动设置TableSelector转换为等价的XPath表达式。
例子:“TableIndex”,2
“TableIndex”,2
数据类型:单|双|int8|int16|int32|int64|uint8|uint16|uint32|uint64
“placeleft”
“placeright”
“复制”
过程处理包含合并列的单元格,指定为此表中的值之一。
将数据放在最左边的单元格中,并用FillValue财产。
将数据放在最右边的单元格中,并用FillValue财产。
复制所有单元格中的数据。
例子:“MergedCellColumnRule”、“placeright”
“MergedCellColumnRule”、“placeright”
MergedCellRowRule
过程处理包含合并行的单元格,指定为此表中的值之一。
“placetop”
将数据放在顶部的单元格中,并用FillValue财产。
“placebottom”
将数据放在底部的单元格中,并用FillValue财产。
例子:“MergedCellRowRule”、“复制”
“MergedCellRowRule”、“复制”
VariableNamesRow
包含变量名的行,指定为非负整数。
如果不指定VariableNamesRow,则该软件根据ReadVariableNames论点。
如果VariableNamesRow是0,则软件不导入变量名。
否则,软件将从指定的行导入变量名。
例子:“VariableNamesRow”,2
“VariableNamesRow”,2
VariableUnitsRow
包含可变单元的行,指定为非负整数。
如果VariableUnitsRow是0,则软件不导入变量单元。否则,软件将从指定的行导入变量单元。
例子:“VariableUnitsRow”,3
“VariableUnitsRow”,3
VariableDescriptionsRow
包含变量描述的行,指定为非负整数。
如果VariableDescriptionsRow是0,则软件不导入变量描述。否则,软件将从指定的行导入变量描述。
例子:“VariableDescriptionsRow”4
“VariableDescriptionsRow”4
输出表,作为表返回。该表可以存储元数据,如描述、变量单位、变量名和行名。有关更多信息,请参见的“属性”部分表格.
表格
XLSX格式的大文件有时加载较慢。为了获得更好的导入和导出性能,Microsoft建议您使用XLSB格式。
使用XPath选择器指定要导入的XML输入文档的哪些元素。例如,假设您想导入XML文件myFile.xml,其结构如下:
myFile.xml
<数据> <表类别= "的" > < var > 1 < / var > < var > 2 < / var > < /表> <表类别= "十" > < var > 10 < / var > < var > 20 < / var > < /表> > < /数据
//
数据=可读(“myFile.xml”,“VariableSelectors”,' / / var ')
数据= 4×1 table var ___ 1 2 10 20
@
数据=可读(“myFile.xml”,“VariableSelectors”,' / /表/ @category ')
数据表categoryAttribute = 2×1 _________________ " 的”“十”
[]
数据=可读(“myFile.xml”,“TableSelector”,/ /表[1]”)
数据= 2×1 table var ___ 1
数据=可读(“myFile.xml”,“VariableSelectors”,/ /表/ var[1]”)
Data = 2×1 table var ___ 1
数据=可读(“myFile.xml”,“VariableSelectors”,”(/ /表/ var)[1]”)
数据=表var ___
全部展开
默认情况下,readtable函数的结果detectImportOptions函数导入表格数据。本质上,这两个函数调用的行为是相同的。
T =可读文件(文件名,detectImportOptions(文件名))
在R2020a中,的默认行为之间有几个区别readtable以及它在以前版本中的默认行为。
输入字段或行的描述
默认R2020areadtable行为
以前版本中的默认行为
第一行没有指定作为输出表变量名的文本
分配名称Var1,…,VarN作为输出表变量的名称
Var1,…,VarN
将数据值的第一行中的值转换为输出表变量的名称
多行文本作为标题行
忽略额外的标题行
将其余行中的值作为检测到的数据类型导入
在输出表的第一行中导入附加标题行作为文本
将其余行中的值作为文本导入
空字段
将检测到的数据类型视为缺失值
将其视为空字符向量或字符串
引号中的值
将其视为检测到的数据类型
将其视为文本
无法转换的文本
非数字字符尾随数字字符,它们之间没有分隔符
将字符视为非数字
对待数字和非数字字符就像用分隔符分隔它们一样
输入文本文件的行具有不同数量的分隔符
返回带有额外变量的输出表
抛出错误消息
打电话给readtable对于R2019b之前的默认行为,使用“格式”、“汽车”名称-值对参数。
T = readtable(文件名,“格式”,“汽车”)
writetable|表格|textscan|导入工具|detectImportOptions|预览|readtimetable|readcell|readmatrix|readvars|setvaropts
writetable
预览
readcell
readmatrix
readvars
Tiene una versión modificada de este ejemplo。¿Desea abrir este ejemplo con sus modificaciones?
Ha hecho clic en unenlace que对应一个este comando de MATLAB:
Ejecute el comando introduciéndolo en la ventana de comandos de MATLAB。Los navegadores web no admit comandos de MATLAB。
选择一个网站,在可用的地方获得翻译的内容,并查看当地的活动和优惠。根据您的地理位置,我们建议您选择:.
您也可以从以下列表中选择网站:
选择中国网站(中文或英文)以获得最佳的网站表现。其他MathWorks国家网站没有针对从您的位置访问进行优化。
联系当地办事处