主要内容

detectImportOptions

基于文件内容的创建导入选项

所有的页面崩溃

语法

选择= detectImportOptions(文件名)
选择= detectImportOptions(文件名、名称、值)

描述

例子

选择= detectImportOptions (文件名)定位一个表在一个文件中,并返回它的导入选项。您可以修改的选项对象,并使用它readtableMATLAB如何控制®进口表格数据。选择返回的类型取决于文件扩展名。例如,函数返回一个SpreadsheetImportOptions如果对象文件名是一个电子表格文件。然而,函数返回一个DelimitedTextImportOptions或FixedWidthImportOptions如果对象文件名是一个文本文件,一个XMLImportOptions如果对象文件名是一个XML文件,一个HTMLImportOptions如果对象文件名是一个HTML文件,和一个WordDocumentImportOptions如果对象文件名是一个微软®词文档。

例子

选择= detectImportOptions (文件名,名称,值)定位的帮助下一个表在一个文件中指定的一个或多个额外的参数名称,值对参数。

例子

全部折叠

打开生活的脚本

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

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

选择= 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
打开生活的脚本

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

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

选择= 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显示表的预览,预览使用

检查类型属性的变量TaxiIn和TaxiOut。

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

改变变量的类型TaxiIn和TaxiOut来双。

选择= 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
打开生活的脚本

检测导入选项一个Microsoft Word文档文件,指定表导入,然后读取数据。

该文件MaintenanceReport.docx包含两个表。第二个表的最后一行包含一个细胞与合并列不匹配表变量。

检测使用导入选项detectImportOptions函数。从第二个表通过设置指定阅读TableIndex来2。

文件名=“MaintenanceReport.docx”;选择= detectImportOptions(文件名,“TableIndex”,2)
选择= WordDocumentImportOptions属性:替换属性:MissingRule:“填补”ImportErrorRule:“填补”EmptyRowRule:“跳过”MergedCellColumnRule:“placeleft”MergedCellRowRule:“placetop”ExtraColumnsRule:“addvars”变量导入属性:设置类型的名字使用setvartype VariableNames:[“描述”“类别”“紧急”“分辨率”“成本”)VariableTypes:[“字符串”“字符串”“字符串”“字符串”"字符串"]SelectedVariableNames:[“描述”“类别”“紧急”“分辨率”“成本”)VariableOptions:显示所有5 VariableOptions访问VariableOptions sub-properties使用setvaropts / getvaropts VariableNamingRule:“保护”位置属性:TableSelector:“(/ / w:(资源)[2]“我们应该:[2正]VariableNamesRow: 1 VariableUnitsRow: 0 VariableDescriptionsRow: 0 RowNamesColumn: 0

跳过阅读行细胞合并列,设置MergedCellColumnRule财产“omitrow”。

选择。MergedCellColumnRule =“omitrow”;

从Microsoft Word文档文件读取表使用readtable函数的选择对象。

文件名=“MaintenanceReport.docx”;T = readtable(文件名,选择)
T =3×5表类别描述紧急解决成本_____________________________________________________________________ ____________________ ________ _____________ ________”项目是偶尔陷入扫描仪卷。”"Mechanical Failure" "Medium" "Readjust Machine" "$45" "Loud rattling and banging sounds are coming from assembler pistons." "Mechanical Failure" "Medium" "Readjust Machine" "$35" "There are cuts to the power when starting the plant." "Electronic Failure" "High" "Full Replacement" "$16200"
打开生活的脚本

检测导入选项一个HTML文件,指定表导入,然后读取数据。

检测导入选项的第一个表的URL//www.tianjin-qmedu.com/help/matlab/text-files.html包含文本“readtable”。检测使用导入选项detectImportOptions功能和使用XPath查询指定表的读" / /表(包含(“readtable”)]”。通过设置指定不读变量名称ReadVariableNames来假。

url =“//www.tianjin-qmedu.com/help/matlab/text-files.html”;选择= detectImportOptions (url,“TableSelector”," / /表(包含(“readtable”)]”,“ReadVariableNames”假)
选择= HTMLImportOptions属性:替换属性:MissingRule:“填补”ImportErrorRule:“填补”EmptyRowRule:“跳过”变量导入属性:设置类型的名字使用setvartype VariableNames: [“Var1”“Var2”] VariableTypes:[“字符串”“字符串”]SelectedVariableNames: [“Var1”“Var2”] VariableOptions:显示所有2 VariableOptions访问VariableOptions sub-properties使用setvaropts / getvaropts VariableNamingRule:“修改”位置属性:TableSelector:“/ /表(包含(“readtable”)]“VariableNamesRow: 0 VariableUnitsRow: 0 VariableDescriptionsRow: 0 RowNamesColumn: 0

读表使用readtable函数。

T = readtable (url,选择)
T =4×2表Var1 Var2 ___________ ____________________________“readtable”“从文件创建表”“writetable”“写表文件”“readtimetable”“从文件创建时间表”“writetimetable”“写时间表文件”
打开生活的脚本

导入文本数据作为字符串数据类型通过指定导入选项。

创建一个对象文件的选项。

选择= detectImportOptions (“outages.csv”);

指定哪个变量导入使用readtable,然后显示一个总结。选择的变量的数据类型字符。

选择。SelectedVariableNames = {“地区”,“原因”};T = readtable (“outages.csv”、选择);总结(T)
变量:地区:1468 x1单元阵列特征向量的原因:1468年x1单元阵列的特征向量

导入文本数据字符串数据类型,然后创建导入选项指定TextType名称-值对。

选择= detectImportOptions (“outages.csv”,“TextType”,“字符串”);

指定哪个变量导入使用readtable,然后显示一个总结。选择的变量的数据类型是现在字符串。

选择。SelectedVariableNames = {“地区”,“原因”};T = readtable (“outages.csv”、选择);总结(T)
变量:地区:1468 x1字符串原因:1468 x1字符串
打开生活的脚本

注册一个定制的XML名称空间前缀的现有名称空间URL输入文件使用RegisteredNamespaces名称-值参数。

创建一个XMLImportOptions对象从一个XML文件。指定的XPath表达式街元素节点的值“VariableSelectors”,注册前缀myPrefix属于的URL街节点。

选择= detectImportOptions (“students.xml”,“RegisteredNamespaces”,(“myPrefix”,“//www.tianjin-qmedu.com”),…“VariableSelectors”," / / myPrefix:街”)
选择= XMLImportOptions属性:替换属性:MissingRule:“填补”ImportErrorRule:“填补”RepeatedNodeRule:“addcol”变量导入属性:设置类型的名字使用setvartype VariableNames:“街道”VariableTypes:“字符串”SelectedVariableNames:“街道”VariableOptions:显示所有1 VariableOptions访问VariableOptions sub-properties使用setvaropts / getvaropts VariableNamingRule:“保护”位置属性:TableSelector: <失踪> RowSelector: <失踪> VariableSelectors:“/ / myPrefix:街”VariableUnitsSelector: <失踪> VariableDescriptionsSelector: <失踪> RowNamesSelector: <失踪> RegisteredNamespaces: (“myPrefix”“//www.tianjin-qmedu.com”)

使用readtable函数以及选择对象导入选定的变量。

T2 = readtable (“students.xml”选择)
T2 =7×1表___________________”591年春巷”“4641珍珠街”“30高地路”“摩尔大街3388号”“摩尔大街3388号”“22安吉驱动”“65迪凯特巷”

输入参数

全部折叠

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

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

位置

形式
当前文件夹或文件夹在MATLAB的道路

指定文件的名称文件名。

例子:“myFile.txt”

文件在一个文件夹

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

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

例子:“\ imgDir \ myFile.txt”
互联网网址

如果文件被指定为一个互联网统一资源定位符(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存储 wasb,wasbs
HDFS™ hdfs

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

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

如果文件名包括文件扩展名detectImportOptions确定的文件格式扩展。否则,你必须指定“文件类型”名称-值对来表示文件的类型。

的detectImportOptions函数支持这些文件扩万博1manbetx展名:. txt,.dat,. csv,xls,.xlsb,.xlsm,.xlsx,.xltm,.xltx,。ods,. xml,。docx,. html,名为. xhtml的,. htm。

请注意

文件扩展名.xlsb和。ods只支持平台与Exc万博1manbetxel®对于Windows®。

数据类型:字符|字符串

名称-值参数

指定可选的双参数作为Name1 = Value1,…,以=家,在那里的名字参数名称和吗价值相应的价值。名称-值参数必须出现在其他参数,但对的顺序无关紧要。

R2021a之前,用逗号来分隔每一个名称和值,并附上的名字在报价。

例子:“文件类型”、“表格”

所有支持万博1manbetx的文件类型

全部折叠

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

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

返回一个SpreadsheetImportOptions对象。
“文本”

返回一个DelimitedTextImportOptions或FixedWidthImportOptions对象根据文本文件的布局。
“delimitedtext”

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

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

返回一个XMLImportOptions对象。使用这个选项为XML文件。
“worddocument”

返回一个WordDocumentImportOptions对象。使用这个选项微软文字处理软件文档文件。
“html”

返回一个HTMLImportOptions对象。使用这个选项为HTML文件。

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

  • . txt,.dat,或. csv为文本文件

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

  • . xml对于XML文件

  • 。docx为微软文字处理软件文档文件

  • . html,名为. xhtml的,或. htmHTML文件

文件扩展名.xlsb和。ods只支持与Excel万博1manbetx为Windows平台。

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

数据类型:字符|字符串

对进口文本数据类型,指定这些值之一:

  • “字符串”——导入文本数据字符串数组。

  • “字符”——导入文本数据为特征向量。

例子:“TextType”、“字符”

进口日期和时间数据类型,指定这些值之一:

价值 描述
“datetime”

MATLABdatetime数据类型

有关更多信息,请参见datetime。
“文本”

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

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

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

Excel串行日期数字

的值“exceldatenum”只适用于电子表格文件,并为文本文件是无效的。串行的日期数一个数字等于给定的参考日期的天数。Excel串行数据使用不同的参考日期比MATLAB数字串行日期。Excel日期的更多信息,请参阅差异在Excel 1900和1904号系统。

指标用于读取第一行作为变量名,指定为逗号分隔组成的“ReadVariableNames”,要么真正的或假。如果未指定的,readtable自动检测的变量名。

指示器

描述

真正的

时使用的第一行地区阅读包含表的变量名。readtable创建一个变量,发现变量名称,每一列的T。

假

时使用的第一行地区读表中包含的数据。readtable创建默认表单的变量名“Var1”,…,“VarN”,在那里N是变量的数量。
未指明的 当离开不明,进口自动检测功能真正的或假并相应收益。

数据类型:逻辑

国旗保存变量名称,指定为“修改”或“保存”。

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

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

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

数据类型:字符|字符串

指标连续阅读第一列名称,指定为逗号分隔组成的“ReadRowNames”,要么假或真正的。

指示器

描述

假

时使用该地区的第一列中读取包含数据,而不是行表的名称。

真正的

时使用的第一列地区读表的名称包含行。
未指明的 当离开不明,导入函数假设假。

数据类型:逻辑

过程管理缺失的数据,指定为这个表中的值之一。

失踪的规则 行为
“填满”

用的内容替换丢失的数据FillValue财产。

的FillValue属性中指定VariableImportOptions变量被导入的对象。有关访问的更多信息FillValue财产,看到getvaropts。
“错误” 停止进口和显示一个错误消息显示丢失的记录和字段。
“omitrow” 省略含有缺失数据的行。
“omitvar” 省略变量包含缺失的数据。

例子:选择。MissingRule =“omitrow”;

数据类型:字符|字符串

指定的程序来处理导入错误,这个表中的值。

导入错误的规则 行为
“填满”

发生错误的数据替换的内容FillValue财产。

的FillValue属性中指定VariableImportOptions变量被导入的对象。有关访问的更多信息FillValue财产,看到getvaropts。
“错误” 停止进口和显示一个错误消息显示error-causing记录和字段。
“omitrow” 省略行发生错误的地方。
“omitvar” 省略变量发生错误的地方。

例子:选择。ImportErrorRule =“omitvar”;

数据类型:字符|字符串

HTTP或HTTPS请求选项,指定为一个weboptions对象。的weboptions当指定的对象决定了如何导入数据文件名互联网是一个URL包含协议类型“http://”或“https://”。

文本和电子表格文件

全部折叠

预期变量的数量,指定为逗号分隔组成的“ExpectedNumVariables”和一个正整数。如果未指定的,导入函数自动检测变量的数量。

数据类型:单|双

的标题行数在这个文件中,指定为逗号分隔组成的“NumHeaderLines”和一个正整数。如果未指定的,导入函数自动检测文件的标题行数。

例子:“NumHeaderLines”7

数据类型:单|双

部分的数据读取文本或电子表格文件,指定为逗号分隔组成的“范围”和一个特征向量,字符串标量或数值向量这些形式之一。

指定的方法范围 描述

从细胞

“细胞”或(行坳)

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

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

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

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

例子:的A5或(5 - 1)

矩形范围

“Corner1: Corner2”或(r1 c1 r2 c2)

指定矩形的确切范围阅读使用范围在这些形式之一。

  • “Corner1: Corner2”——指定范围内使用Corner1和Corner2这是两个对立的角落,定义该地区在Excel中读A1符号。例如,“C2: N15”。

  • (r1 c1 r2 c2)——使用四个元素指定范围数值向量包含起始行、起始列,结束行,结束列。例如,(2 3 15 13)。

导入函数只读取数据包含在指定的范围内。任何空字段指定范围内进口失踪细胞。

行或列范围范围

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

指定开始和结束行通过识别范围使用Excel行数。

使用指定的行范围,导入函数自动检测列程度通过阅读从第一个非空的列的数据,并创建一个变量,每列。

例子:“5:500”

另外,指定范围确定的开始和结束列使用Excel列字母或数字。

使用指定的列范围,导入函数自动检测行程度通过阅读从第一个非空的行或页脚的数据范围的结束。

指定范围的列数必须匹配指定的数量ExpectedNumVariables财产。

例子:“答:K”

起始行号

n

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

使用指定的行索引,导入函数自动检测数据通过阅读的程度从指定的第一行或页脚的数据范围的结束。

例子:5

Excel的命名范围

“NamedRange”

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

例子:“范围”、“myTable”

不明或空

”

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

例子:“范围”,“

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

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

参数仅供电子表格文件

全部折叠

读取表,指定为一个空字符数组,一个特征向量或字符串标量包含表的名称,或积极的标量整数表示表索引。基于指定的值的表属性,表中描述的导入功能的行为。

规范 行为
”(默认) 从第一张工作表导入数据。
的名字 导入匹配的数据表名称,不管订单表的电子表格文件。
整数 导入数据表的位置用整数,无论表名称的电子表格文件。

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

指定位置的数据被导入,作为特征向量,字符串标量,单元阵列的特征向量,或一个字符串数组,积极标量整数N——- - - - - -2积极的标量的整型数组。指定DataRange使用这些形式之一。

指定的 行为

“细胞”或n

从细胞或行开始

指定的起始单元格数据,使用ExcelA1符号。例如,A5的标识符是细胞在列的交集一个和行5。

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

另外,指定包含数据的第一行使用积极的标量行索引。

使用指定的行索引,导入函数自动检测数据通过阅读的程度从指定的第一行或页脚的数据范围的结束。

例子:的A5或5

”Corner1: Corner2”

矩形范围

使用矩形范围内指定的确切范围阅读形式,Corner1和Corner2是两个对立的角落,定义该地区读。

导入函数只读取数据包含在指定的范围内。任何空字段指定范围内进口失踪细胞。

列数必须匹配指定的数量NumVariables财产。

例子:“A5: K50”

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

行或列范围范围

指定开始和结束行通过识别范围使用Excel行数。

使用指定的行范围,导入函数自动检测列程度通过阅读从第一个非空的列的数据,并创建一个变量,每列。

例子:“5:500”

另外,指定范围确定的开始和结束列使用Excel列字母或数字。

使用指定的列范围,导入函数自动检测行程度通过阅读从第一个非空的行或页脚的数据范围的结束。

指定范围的列数必须匹配指定的数量NumVariables财产。

例子:“答:K”

(n1 n2;n3陶瓷;……)

多个行范围

指定多个行范围读的N——- - - - - -2数组包含N不同的行范围。

一系列有效的多个行范围必须:

  • 指定行范围越来越顺序,第一行数组中指定的范围出现在文件在其他行范围。

  • 只包含重叠行范围。

使用正只支持表明最后范万博1manbetx围数值数组中指定多个行范围。例如,[1 3;5 6;8正)。

例子:[1 3;5 6;8正)

”

不明或空

不获取任何数据。

例子:”

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

指定的行名称,位置作为特征向量,字符串标量,积极的标量整数,或一个空字符数组。指定RowNamesRange在这个表的值。

指定的 行为

“细胞”

指定的起始单元格数据,使用ExcelA1符号。例如,A5的标识符是细胞在列的交集一个和行5。

导入函数识别数据中的每个变量的名称。

例子:的A5

”Corner1: Corner2”

矩形范围

使用矩形范围内指定的确切范围阅读形式,Corner1和Corner2是两个对立的角落,定义该地区读。

中包含的行数RowNamesRange必须匹配的数据行数,表示范围RowNamesRange必须跨越只有一列。

例子:“A5: A50”

”第一行:Row2”

行范围

指定范围通过识别开始和结束行用Excel行数。

行名称必须在一个单一的列。

例子:“25”

n

数量指标

指定的列包含行名称使用积极的标量列索引。

例子:5

”

不明或空

表明没有行名称。

例子:”

数据类型:字符|单|双

指定的变量名,位置作为特征向量,字符串标量,积极的标量整数,或一个空字符数组。指定VariableNamesRange在这个表的值。

指定的 行为

“细胞”

指定的起始单元格数据,使用ExcelA1符号。例如,A5的标识符是细胞在列的交集一个和行5。

导入函数读取数据中每个变量的名称。

例子:的A5

”Corner1: Corner2”

矩形范围

使用矩形范围内指定的确切范围阅读形式,Corner1和Corner2是两个对立的角落,定义该地区读。

列数必须匹配指定的数量NumVariables财产,必须跨越范围只有一行。

例子:“A5: K5”

”第一行:Row2”

行范围

指定范围通过识别开始和结束行用Excel行数。

必须一行。

例子:“5”

n

数量指标

指定行包含使用积极的标量变量名称行索引。

例子:5

”

不明或空

表明没有变量名。

例子:”

数据类型:字符|单|双

位置变量的单位,指定为一个特征向量,字符串标量,积极的标量整数,或一个空字符数组。指定VariableUnitsRange在这个表的值。

指定的 行为

“细胞”

指定的起始单元格数据,使用ExcelA1符号。例如,A5的标识符是细胞在列的交集一个和行5。

导入函数读取单元的每个变量的数据。

例子:的A5

”Corner1: Corner2”

矩形范围

使用矩形范围内指定的确切范围阅读形式,Corner1和Corner2是两个对立的角落,定义该地区读。

列数必须匹配指定的数量NumVariables财产,必须跨越范围只有一行。

例子:“A5: K5”

”第一行:Row2”

行范围

指定范围通过识别开始和结束行用Excel行数。

必须一行。

例子:“5”

n

数量指标

指定行包含数据单元使用积极的标量行索引。

例子:5

”

不明或空

表明没有变量单位。

例子:”

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

指定的位置变量描述,作为特征向量,字符串标量,积极的标量整数,或一个空字符数组。指定VariableDescriptionRange在这个表的值。

指定的 行为

“细胞”

指定的起始单元格数据,使用ExcelA1符号。例如,A5的标识符是细胞在列的交集一个和行5。

导入函数读取数据中每个变量的描述。

例子:的A5

”Corner1: Corner2”

矩形范围

使用矩形范围内指定的确切范围阅读形式,Corner1和Corner2是两个对立的角落,定义该地区读。

列数必须匹配指定的数量NumVariables财产,必须跨越范围只有一行。

例子:“A5: K5”

”第一行:Row2”

行范围

指定范围通过识别开始和结束行用Excel行数。

必须一行。

例子:“5”

n

数量指标

指定行包含描述使用积极的标量行索引。

例子:5

”

不明或空

表明没有变量描述。

例子:”

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

参数仅供文本文件

全部折叠

字段分隔符字符分隔的文本文件,指定为一个字符串数组,特征向量,或单元阵列特征向量。

例子:“分隔符”、“|”

例子:“分隔符”,(“;”,“*”)

过程管理主要分隔符分隔的文本文件,指定为这个表中的值之一。

价值 行为
“保持” 分隔符。
“忽略” 忽略了分隔符。
“错误” 返回一个错误,取消导入操作。

过程管理落后于分隔符分隔的文本文件,指定为这个表中的值之一。

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

过程管理连续分隔符分隔的文本文件,指定为这个表中的值之一。

价值 行为
“分裂” 将连续分隔符分割为多个字段。
“加入” 加入分隔符为一个分隔符。
“错误” 返回一个错误,取消导入操作。

的变量字段宽度固定宽度的文本文件,指定为一个向量的正整数的值。中的每个正整数向量对应的字段中的字符数变量。的VariableWidths属性包含一个条目对应于每个变量中指定VariableNames财产。

字符视为空白,指定为一个特征向量包含一个或多个字符或字符串标量。

例子:“空白”、“_”

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

行尾字符,指定为一个字符串数组,特征向量,或单元阵列特征向量。

例子:“LineEnding”、“\ n”

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

例子:“LineEnding”(“\ b”,“:”)

字符编码方案相关文件,指定为逗号分隔组成的“编码”和“系统”或一个标准字符编码方案的名字。

当你不指定任何编码,该函数使用自动字符集检测来确定当读取文件的编码。

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

数据类型:字符|字符串

风格的评论,指定为一个字符串数组,特征向量,或单元阵列特征向量。单和多行注释,起始标识符必须是第一个非空白字符。对于单行注释,指定一个标识符将线从标识符作为评论。多行注释,台词开始(第一)标识符结束(秒)标识符被当作注释。不超过两个特征向量的标识符可以指定。

例如,忽略线百分之一符号作为第一个非空白字符后,指定CommentStyle作为“%”。

例子:“CommentStyle”(“/ *”)

例子:“CommentStyle”(“/ *”、“* /”)

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

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

MATLAB持续时间数据类型

有关更多信息,请参见持续时间。
“文本”

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

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

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

数据类型:字符|字符串

过程来处理额外的列数据,指定为这个表中的值之一。

额外的列规则 行为
“addvars”

进口额外的列,创建新的变量。如果有N额外的列,然后导入新的变量“ExtraVar1”、“ExtraVar2’,……、“ExtraVarN”。如果他们额外的列的数据被导入VariableTypes是字符。
“忽略” 忽略额外的列的数据。
“包装” 包装的额外列数据新记录。此操作不会改变变量的数量。
“错误” 显示一个错误消息并中止导入操作。

数据类型:字符|字符串

文本解释缺失的数据,指定为一个特征向量,字符串标量,单元阵列的特征向量,或字符串数组。

当导入函数发现缺失的情况下,它使用的规范MissingRule属性来确定适当的行动。

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

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

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

  • YY是一个大写的ISO 3166 - 1α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”

字符显示数以千计在数值变量分组,指定为一个特征向量或字符串标量。数以千计的分组角色扮演视觉分隔符,分组数量在每三个地方的价值观。导入函数中使用的人物ThousandsSeparator属性解释数据被导入。

数据类型:字符|字符串

字符表示的十进制分隔符数值变量指定为一个特征向量或字符串标量。导入函数使用DecimalSeparator属性来区分一个数的整数部分和小数部分。

当转换成整数数据类型、数量与小数部分四舍五入为最接近的整数。

数据类型:字符|字符串

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

数据类型:逻辑

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

输入文件表示十六进制值为文本,使用0 x或0 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 b或0 b作为前缀字符0和1作为数字。

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

的价值“BinaryType”

输出表变量的数据类型

“汽车”

数据类型自动检测

“文本”

改变输入文本

“int8”

8位整数,签署了

“int16”

16位整数,签署了

“int32”

32位整数,签署了

“int64”

64位整数,签名

“uint8”

8位整数,无符号

“uint16”

16位整数,无符号

“uint32”

32位整数,无符号

“uint64”

64位整数,无符号

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

数据类型:字符|字符串

XML文件只

全部折叠

导入属性,指定为逗号分隔组成的“ImportAttributes”,要么1(真正的)或0(假)。如果您指定假阅读,那么函数将不导入XML输入文件中的属性变量输出表中。

例子:“ImportAttributes”,假的

后缀属性,指定为逗号分隔组成的“AttributeSuffix”和一个特征向量或字符串标量。这个参数指定后缀阅读函数附加到所有表变量对应于输入XML文件中的属性。如果你不指定“AttributeSuffix”,然后阅读功能默认为附加后缀“属性”对所有变量名称对应于输入XML文件中的属性。

例子:“AttributeSuffix”、“_att”

表行XML节点名称,指定为逗号分隔组成的“RowNodeName”和一个特征向量或字符串标量。这个参数指定了XML节点名称,描绘了输出表的行。

例子:“RowNodeName”、“XMLNodeName”

矢量表行XPath表达式,指定为一个字符或字符串标量函数使用阅读选择个人输出表的行。您必须指定RowSelector作为一个有效的XPath 1.0表达式。

例子:“RowSelector”、“RootNode / ChildNode”

表变量XML节点名称,指定为逗号分隔组成的“VariableNodeNames”和特征向量的细胞数组或字符串数组。这个参数指定阅读函数使用的XML节点名称识别XML节点输出表中读取为变量。

例子:VariableNodeNames, {‘XMLNodeName1’,‘XMLNodeName2}

例子:“VariableNodeNames”、“XMLNodeName”

例子:“VariableNodeNames”, (“XMLNodeName1”、“XMLNodeName2”)

表变量XPath表达式,指定为一个单元阵列的特征向量数组或字符串读取函数使用选择表变量。您必须指定VariableSelectors作为有效的XPath表达式1.0版本。

例子:VariableSelectors, {' / RootNode / ChildNode '}

例子:‘VariableSelectors’,”/ RootNode / ChildNode”

例子:“VariableSelectors”, (“/ RootNode / ChildNode1”,“/ RootNode / ChildNode2”)

表的XML节点名称,指定为逗号分隔组成的“TableNodeName”和一个特征向量或字符串标量。这个参数指定节点的输入结构,阅读函数应该读表。

例子:“TableNodeName”、“节点名的

XPath变量单位,指定为一个特征向量或字符串标量函数所使用的阅读选择表变量单位。您必须指定VariableUnitsSelector作为一个有效的XPath 1.0表达式。

例子:“VariableUnitsSelector”、“RootNode / ChildNode”

变量描述XPath表达式,指定为一个特征向量或字符串标量阅读函数读取使用选择表变量描述。您必须指定VariableDescriptionsSelector作为一个有效的XPath 1.0表达式。

例子:“VariableDescriptionsSelector”、“RootNode / ChildNode”

XPath表达式表行名称,指定为一个特征向量或字符串标量函数所使用的阅读选择的名称表行。您必须指定RowNamesSelector作为一个有效的XPath 1.0表达式。

例子:“RowNamesSelector”、“RootNode / ChildNode”

程序处理重复表的XML节点在一个给定的行,指定为“addcol”,“忽略”,或“错误”。

重复节点规则

行为
“addcol”

添加列重复节点变量下表中的标题。指定的值“RepeatedNodeRule”作为“addcol”不创建一个单独的表中变量的重复节点。
“忽略”

跳过导入重复的节点。
“错误” 显示一个错误消息并中止导入操作。

例子:“RepeatedNodeRule”、“忽略”

组注册XML名称空间前缀指定为逗号分隔组成的RegisteredNamespaces和一个前缀数组。阅读函数使用这些前缀在评估XPath表达式在一个XML文件。指定名称空间前缀和它们相关的url作为Nx2字符串数组。RegisteredNamespaces还可以使用当你评估一个XPath表达式指定的选择器名称参数,如StructSelector为readstruct,或VariableSelectors为readtable和readtimetable。

默认情况下,阅读功能自动检测名称空间前缀注册使用XPath的评价,但是你也可以注册新使用的名称空间前缀RegisteredNamespaces名称-值参数。你可以注册一个新的名称空间前缀当XML节点的名称空间URL,但没有在XML文件中声明的名称空间前缀。

例如,评估一个XPath表达式在一个XML文件example.xml这并不包含一个名称空间前缀。指定“RegisteredNamespaces”作为[" myprefix ", " //www.tianjin-qmedu.com ")分配前缀myprefix到URL//www.tianjin-qmedu.com。

T = readtable(“的例子。xml”、“VariableSelector”、“/ myprefix:数据”,……“RegisteredNamespaces”, [" myprefix ", " //www.tianjin-qmedu.com "])

例子:“RegisteredNamespaces”, (“myprefix”、“//www.tianjin-qmedu.com”)

微软词文档和HTML文件

全部折叠

读取索引的表微软文字处理软件文档包含多个表或HTML文件,指定为一个正整数。

当你指定TableIndex,软件自动设置TableSelector等价的XPath表达式。

数据类型:单|双|int8|int16|int32|int64|uint8|uint16|uint32|uint64

程序处理细胞合并列,指定为这个表中的值之一。

导入错误的规则 行为
“placeleft”

左边的单元格中的数据和用的内容填满剩下的细胞FillValue财产。

的FillValue属性中指定VariableImportOptions变量被导入的对象。有关访问的更多信息FillValue财产,看到getvaropts。
“placeright”

把数据放在最右边细胞用的内容填满剩下的细胞FillValue财产。

的FillValue属性中指定VariableImportOptions变量被导入的对象。有关访问的更多信息FillValue财产,看到getvaropts。
“复制”

在所有的细胞中复制数据。
“omitrow” 省略行发生错误的地方。
“错误” 显示一个错误消息并中止导入操作。

程序处理细胞合并行,指定为这个表中的值之一。

导入错误的规则 行为
“placetop”

把数据在顶端细胞和用的内容填满剩下的细胞FillValue财产。

的FillValue属性中指定VariableImportOptions变量被导入的对象。有关访问的更多信息FillValue财产,看到getvaropts。
“placebottom”

底细胞中的数据和用的内容填满剩下的细胞FillValue财产。

的FillValue属性中指定VariableImportOptions变量被导入的对象。有关访问的更多信息FillValue财产,看到getvaropts。
“复制”

在所有的细胞中复制数据。
“omitvar” 省略变量合并行发生的地方。
“错误” 显示一个错误消息并中止导入操作。

行包含变量名称,指定为一个非负整数。

  • 如果你不指定VariableNamesRow,然后根据软件读取变量名称ReadVariableNames论点。

  • 如果VariableNamesRow是0,那么软件不能导入变量名。

  • 否则,软件进口的变量名称指定行。

数据类型:单|双|int8|int16|int32|int64|uint8|uint16|uint32|uint64

行包含变量单位,指定为一个非负整数。

如果VariableUnitsRow是0,那么软件不能导入变量单位。否则,软件导入变量单位指定的行。

数据类型:单|双|int8|int16|int32|int64|uint8|uint16|uint32|uint64

行包含变量描述,指定为一个非负整数。

如果VariableDescriptionsRow是0,那么软件不能导入变量描述。否则,软件导入变量描述从指定的行。

数据类型:单|双|int8|int16|int32|int64|uint8|uint16|uint32|uint64

规则适用于表中的空行,指定为以下之一:

  • “跳过”——跳过空行。

  • “读”——读空行。

  • “错误”在表——忽略空行检测和误差时阅读。

规则适用于空表中的列,指定为以下之一:

  • “跳过”——跳过空的列。

  • “读”——读空的列。

  • “错误”——忽略空的列在表检测和错误当阅读。

微软词文档、HTML和XML文件

全部折叠

表数据XPath表达式,指定为一个特征向量或字符串标量,阅读函数使用选择输出表数据。您必须指定TableSelector作为一个有效的XPath 1.0表达式。

例子:“TableSelector”、“RootNode / ChildNode”

输出参数

全部折叠

导入选项指定的文件,作为一个返回SpreadsheetImportOptions,DelimitedTextImportOptions,FixedWidthImportOptions,或XMLImportOptions对象。选择对象的类型取决于指定的文件类型。对于文本文件(. txt,.dat,或. csv),detectImportOptions函数返回一个DelimitedTextImportOptions或FixedWidthImportOptions对象。为电子表格文件(xls,.xlsb,.xlsm,.xlsx,.xltm,.xltx,或。ods),detectImportOptions函数返回一个SpreadsheetImportOptions对象。对XML文件(. xml),detectImportOptions返回一个XMLImportOptions对象。

提示

  • 更新属性值在创建导入选项对象:不推荐使用点符号更新导入选项创建的对象的属性detectImportOptions。当你设置属性使用点符号,MATLAB并不re-detect所有进口文件的选项。因此,更新和re-detect所有属性,您必须指定新值通过使用名称-值参数。例如,更新的值ConsecutiveDelimitersRule财产和re-detect导入选项如下。

    选择= detectImportOptions (__,“ConsecutiveDelimitersRule”,“加入”)

  • 使用XPath选择器来指定哪些元素的XML输入文档导入。例如,假设您想要导入的XML文件myFile.xml,它具有以下结构:

    <数据> <表类别= " 1 " > < var > 1 < / var > < var > 2 < / var > < /表> <表类别= "十" > < var > 10 < / var > < var > 20 < / var > < /表> < /数据>
    这个表提供的XPath语法支持XPath选择器名称参数,如万博1manbetxVariableSelectors或TableSelector。

    选择操作 语法 例子 结果
    选择每个节点名称和节点相匹配的你想选择,无论其位置在文档中。 与两个斜杠(前缀的名称/ /)。 
    数据= readtable (“myFile.xml”,“VariableSelectors”,' / / var ')
    		 
    数据表var = 4×1 1 2 10 20
    读一个属性的值属于一个元素节点。 前缀的属性与一个符号(@)。 
    数据= readtable (“myFile.xml”,“VariableSelectors”,' / /表/ @category ')
    		 
    data = 2×1表categoryAttribute _________________“的”“十”
    在一组节点选择一个特定的节点。 提供的索引节点你想选择在方括号([])。 
    数据= readtable (“myFile.xml”,“TableSelector”,/ /表[1]”)
    		 
    数据表var = 2×1 1 2
    指定操作的优先级。 加括号的表达式你想先评估。 
    数据= readtable (“myFile.xml”,“VariableSelectors”,/ /表/ var [1]”)
    		 
    data = 2×1表var ___ 1 10
    		 
    数据= readtable (“myFile.xml”,“VariableSelectors”,”(/ /表/ var) [1]”)
    		 
    数据表var ___ = 1

版本历史

介绍了R2016b

另请参阅

||||||

主题