主要内容

detectImportOptions

根据文件内容创建导入选项

描述

例子

选择= detectImportOptions (文件名定位文件中的表并返回其导入选项。您可以修改options对象并使用它readtable如何控制MATLAB®导入表格数据。返回的选项类型取决于文件扩展名。例如,函数返回一个SpreadsheetImportOptions如果对象文件名是电子表格文件。然而,该函数返回一个DelimitedTextImportOptionsFixedWidthImportOptions如果对象文件名是文本文件,还是XMLImportOptions如果对象文件名是XML文件,是HTMLImportOptions如果对象文件名是HTML文件,而WordDocumentImportOptions如果对象文件名是一个微软®文档。

例子

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

例子

全部折叠

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

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

opts = detectImportOptions(“patients.xls”
替换属性:MissingRule: 'fill' ImportErrorRule: 'fill'变量导入属性:使用setvartype VariableNames:{'姓氏','性别','年龄'按名称设置类型…变量类型:{'char', 'char', 'double'…SelectedVariableNames:{'姓','性别','年龄'…使用setvaropts/getvaropts VariableOptions:显示所有10个VariableOptions访问VariableOptions子属性VariableNamingRule: 'modify' Range Properties: DataRange: 'A2' (Start Cell) VariableNamesRange: 'A1' RowNamesRange: " VariableUnitsRange: " VariableDescriptionsRange: "要显示表格的预览,请使用preview

修改options对象以指定要导入哪些变量。

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

使用readtable连同options对象一起导入指定的变量。

T =可读的(“patients.xls”、选择);总结(T)
变量:收缩压:100x1 double值:Min 109中位数122最大138舒张压:100x1 double值:Min 68中位数81.5最大99

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

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

opts = detectImportOptions(“airlinesmall.csv”
opts = DelimitedTextImportOptions带属性:格式属性:分隔符:{','}空白:'\b\t ' LineEnding: {'\n' '\r' '\r\n'} CommentStyle: {} ConsecutiveDelimitersRule: 'split' LeadingDelimitersRule: 'keep' TrailingDelimitersRule: 'ignore' EmptyLineRule: 'skip' Encoding: 'ISO-8859-1'替换属性:MissingRule: 'fill' ImportErrorRule: 'fill' ExtraColumnsRule: 'addvars'变量导入属性:使用setvartype VariableNames按名称设置类型:{“年”、“月”、“月之日”……和26个}变量类型:{'double', 'double', 'double'…和26个}selectedvariablename:{'年','月','月日'…使用setvaropts/getvaropts VariableNamingRule: 'modify'位置属性:DataLines: [2 Inf] VariableNamesLine: 1 RowNamesColumn: 0 VariableUnitsLine: 0 VariableDescriptionsLine: 0要显示表的预览,使用preview

检查类型变量的性质TaxiInTaxiOut

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

改变变量的类型TaxiInTaxiOut

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

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

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

使用readtable函数和options对象一起导入所选变量。显示表的摘要。

T =可读的(“airlinesmall.csv”、选择);总结(T)
变量:TaxiIn: 123523x1 double值:Min 0 Median 5 Max 1451 NumMissing 37383 TaxiOut: 123523x1 double值:Min 0 Median 13 Max 755 NumMissing 37364

检测microsoftword文档文件的导入选项,指定要导入的表,然后读取数据。

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

方法检测导入选项detectImportOptions函数。通过设置指定从第二个表中读取TableIndex2

文件名=“MaintenanceReport.docx”;opts = detectImportOptions(文件名,“TableIndex”, 2)
替换属性:MissingRule: "fill" ImportErrorRule: "fill" EmptyRowRule: "skip" MergedCellColumnRule: " placelefleft " MergedCellRowRule: "placetop" ExtraColumnsRule: "addvars"变量导入属性:使用setvartype VariableNames: ["Description" "Category"…VariableTypes: ["string" "string" "string" "string"…SelectedVariableNames: ["Description" "Category"…[2 Inf] variablelenamesrow: 1 VariableUnitsRow: 0 VariableDescriptionsRow: 0 RowNamesColumn: 0

若要跳过读取具有合并列的单元格的行,请设置MergedCellColumnRule财产“omitrow”

选择。MergedCellColumnRule =“omitrow”

方法从microsoftword文档文件中读取表readtable使用options对象函数。

文件名=“MaintenanceReport.docx”;T = readtable(文件名,opts)
T =3×5表类别描述紧急解决成本  _____________________________________________________________________ ____________________ ________ __________________ ________ " 项目是偶尔陷入扫描仪卷。”“机械故障”“中等”“重新调整机”“45美元”“组装活塞发出巨大的嘎嘎声和砰砰声。”“机械故障”“中等”“重新调整机器”“35美元”“启动工厂时,电源会被切断。”“电子故障”“高”“全部更换”“$16200”

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

检测URL中第一个表的导入选项//www.tatmou.com/help/matlab/text-files.html包含文本“readtable”。方法检测导入选项detectImportOptions函数,并使用XPath查询指定要读取的表" / /表(包含(“readtable”)]”.通过设置指定不读取变量名ReadVariableNames

url =“//www.tatmou.com/help/matlab/text-files.html”;opts = detectImportOptions(url“TableSelector”" / /表(包含(“readtable”)]”“ReadVariableNames”假)
opts = HTMLImportOptions与属性:替换属性:MissingRule: "fill" ImportErrorRule: "fill" EmptyRowRule: "skip"变量导入属性:通过名称设置类型使用setvartype VariableNames: ["Var1" "Var2"] VariableTypes: ["string" "string"] SelectedVariableNames: ["Var1" "Var2"] VariableOptions:显示所有2个VariableOptions访问VariableOptions子属性使用setvaropts/getvaropts VariableNamingRule: "modify"位置属性:TableSelector:"//TABLE[contains(.,'readtable')]" VariableNamesRow: 0 VariableUnitsRow: 0 VariableDescriptionsRow: 0 RowNamesColumn: 0 .

方法读取表readtable函数。

T = readtable(url,opts)
T =4×2表Var1 Var2 ________________ ____________________________ "readtable" "从文件创建表" "writetable" "写表文件" " read时间表" "从文件创建时间表" " write时间表" "写时间表文件"

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

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

opts = detectImportOptions(“outages.csv”);

指定要使用哪些变量导入readtable,然后显示一个摘要。所选变量的数据类型为字符

选择。SelectedVariableNames = {“地区”“原因”};T =可读的(“outages.csv”、选择);总结(T)
变量:区域:1468x1单元格字符向量数组原因:1468x1单元格字符向量数组

导入文本数据作为字符串数据类型,然后通过指定TextType名称-值对。

opts = detectImportOptions(“outages.csv”“TextType”“字符串”);

指定要使用哪些变量导入readtable,然后显示一个摘要。所选变量的数据类型为现在字符串

选择。SelectedVariableNames = {“地区”“原因”};T =可读的(“outages.csv”、选择);总结(T)
变量:区域:1468x1 string原因:1468x1 string

属性将自定义XML名称空间前缀注册到输入文件中的现有名称空间URLRegisteredNamespaces名称-值参数。

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

opts = detectImportOptions(“students.xml”“RegisteredNamespaces”, (“myPrefix”“//www.tatmou.com”),...“VariableSelectors”" / / myPrefix:街”
替换属性:MissingRule: "fill" ImportErrorRule: "fill" RepeatedNodeRule: "addcol"变量导入属性:按名称设置类型使用setvartype VariableNames: "Street" VariableTypes: "string" SelectedVariableNames: "Street" VariableOptions:显示所有1个VariableOptions访问VariableOptions子属性使用setvaropts/getvaropts VariableNamingRule: "preserve"位置属性:TableSelector:  RowSelector: variableelectors: "//myPrefix:Street" VariableUnitsSelector:  VariableDescriptionsSelector:  RowNamesSelector:  RegisteredNamespaces: ["myPrefix" "//www.tatmou.com/au/"]

使用readtable函数连同options对象一起导入所选变量。

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

输入参数

全部折叠

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

根据文件的位置,文件名可以变成这些形式之一。

位置

形式

当前文件夹或MATLAB路径下的文件夹

中指定文件的名称文件名

例子:“myFile.txt”

文件夹中的文件

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

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

例子:“\ imgDir \ myFile.txt”

互联网网址

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

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

远程位置

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

scheme_name: / /path_to_file/my_file.ext

根据位置的远近scheme_name可以是本表中的值之一。

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

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

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

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

detectImportOptions函数支持以下文件扩金宝app展名:. txt.dat. csvxls.xlsb.xlsm.xlsx.xltm.xltx。ods. xml。docx. html名为. xhtml的,. htm

请注意

文件扩展名.xlsb。ods只在Excel平台金宝app上支持®对于Windows®

数据类型:字符|字符串

名称-值参数

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

例子:“文件类型”、“表格”
所有支持金宝app的文件类型

全部折叠

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

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

返回一个SpreadsheetImportOptions对象。

“文本”

返回一个DelimitedTextImportOptionsFixedWidthImportOptions对象,这取决于文本文件的布局。

“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 金宝appfor Windows平台。

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

数据类型:字符|字符串

类型,指定为逗号分隔的对,由“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

数据类型:字符|字符串

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

指示器

描述

真正的

当要读取的区域的第一行包含表的变量名时使用。readtable中的每一列都创建一个具有检测到的变量名的变量T

当要读取的区域的第一行包含表中的数据时使用。readtable创建表单的默认变量名“Var1”,…,“VarN”,在那里N是变量的数量。

未指明的 如果不指定,导入函数将自动检测真正的并相应地进行。

数据类型:逻辑

标记以保留变量名,指定为任意一种“修改”“保存”

  • “修改”-转换无效的变量名(由isvarname函数)到有效的MATLAB标识符。

  • “保存”-保留不是有效MATLAB标识符的变量名,例如包含空格和非ascii字符的变量名。

从R2019b开始,变量名和行名可以包含任何字符,包括空格和非ascii字符。此外,他们可以从任何字符开始,而不仅仅是字母。变量名和行名不必是有效的MATLAB标识符(由isvarname功能)。若要保留这些变量名和行名,请设置值VariableNamingRule“保存”.的值时,变量名不会刷新VariableNamingRule“修改”“保存”

数据类型:字符|字符串

将第一列读取为行名的指示器,指定为逗号分隔的对,由“ReadRowNames”,要么真正的

指示器

描述

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

真正的

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

未指明的 当未指定时,导入函数假定

数据类型:逻辑

过程来管理缺失的数据,该数据指定为本表中的值之一。

失踪的规则 行为
“填满”

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

FillValue属性中指定VariableImportOptions正在导入的变量的。有关访问的详细信息FillValue财产,看到getvaropts

“错误” 停止导入并显示错误消息,显示丢失的记录和字段。
“omitrow” 省略包含缺失数据的行。
“omitvar” 省略包含缺失数据的变量。

例子:选择。MissingRule = 'omitrow';

数据类型:字符|字符串

过程来处理导入错误,该错误指定为本表中的值之一。

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

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

FillValue属性中指定VariableImportOptions正在导入的变量的。有关访问的详细信息FillValue财产,看到getvaropts

“错误” 停止导入并显示错误消息,显示导致错误的记录和字段。
“omitrow” 省略发生错误的行。
“omitvar” 省略发生错误的变量。

例子:选择。ImportErrorRule = 'omitvar';

数据类型:字符|字符串

文本和电子表格文件

全部折叠

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

数据类型:|

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

例子:“NumHeaderLines”7

数据类型:|

要从文本或电子表格文件中读取的数据的一部分,指定为由逗号分隔的对组成“范围”以及这些形式之一的字符向量、字符串标量或数字向量。

指定方法范围 描述

从细胞

“细胞”(行坳)

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

  • 使用Excel包含列字母和行号的字符向量或字符串标量A1符号。例如,A5单元格的标识符是列的交叉点吗一个和行5

  • 二元数值向量的形式(行坳)指示起始行和列。

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

例子:的A5(5 - 1)

矩形范围

“Corner1: Corner2”[r1 c1 r2 c2]

使用其中一种形式的矩形范围指定要读取的确切范围。

  • “Corner1: Corner2”—指定使用的范围Corner1Corner2在Excel中,哪两个相对的角定义了要读取的区域A1符号。例如,“C2: N15”

  • [r1 c1 r2 c2]—使用包含开始行、开始列、结束行和结束列的四元素数字向量指定范围。例如,[2 3 15 13]

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

行范围或列范围

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

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

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

例子:“5:500”

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

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

属性中指定的列数必须匹配ExpectedNumVariables财产。

例子:“答:K”

起始行号

n

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

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

例子:5

Excel的命名范围

“NamedRange”

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

例子:“范围”、“myTable”

未指定或为空

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

例子:“范围”,“

注意:使用范围指电子表格中实际包含数据的矩形部分。导入函数通过修改不包含数据的任何开头和结尾行和列来自动检测所使用的范围。仅为空白的文本被认为是数据,并在使用的范围内捕获。

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

参数仅适用于电子表格文件

全部折叠

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

规范 行为
(默认) 从第一个工作表导入数据。
的名字 从匹配的工作表名称导入数据,而不管工作表在电子表格文件中的顺序如何。
整数 从表中导入由整数表示的位置的数据,而不管电子表格文件中的表名如何。

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

要导入的数据的位置,指定为字符向量、字符串标量、字符向量的单元格数组、字符串数组、正标量整数或N——- - - - - -2正标量整数数组。指定DataRange使用这些形式之一

指定的 行为

“细胞”n

开始单元格或开始行

使用Excel指定数据的起始单元格A1符号。例如,A5单元格的标识符是列的交叉点吗一个和行5

导入函数使用起始单元格自动检测数据的范围,方法是在起始单元格开始导入,并在最后一个空行或页脚范围结束导入。

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

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

例子:的A55

Corner1: Corner2

矩形范围

使用矩形范围形式指定要读取的确切范围,其中Corner1Corner2是两个相对的角,它们定义了要读取的区域。

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

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

例子:“A5: K50”

第一行:Row2Column1: Column2

行范围或列范围

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

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

例子:“5:500”

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

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

属性中指定的列数必须匹配NumVariables财产。

例子:“答:K”

(n1 n2;n3陶瓷;……)

多行范围

指定多行范围用英语阅读N——- - - - - -2数组包含N不同的行范围。

由多个行范围组成的有效数组必须:

  • 按递增顺序指定行范围,即在数组中指定的第一行范围在其他行范围之前出现在文件中。

  • 只包含不重叠的行范围。

使用仅支持用于指示指金宝app定多个行范围的数值数组中的最后一个范围。例如,[1 3;5 6;8正)

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

未指定或为空

不要获取任何数据。

例子:

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

行名的位置,指定为字符向量、字符串标量、正标量整数或空字符数组。指定RowNamesRange作为该表中的值之一。

指定的 行为

“细胞”

使用Excel指定数据的起始单元格A1符号。例如,A5单元格的标识符是列的交叉点吗一个和行5

导入函数为数据中的每个变量标识一个名称。

例子:的A5

Corner1: Corner2

矩形范围

使用矩形范围形式指定要读取的确切范围,其中Corner1Corner2是两个相对的角,它们定义了要读取的区域。

中包含的行数RowNamesRange必须匹配数据行数,以及由RowNamesRange只能张成一列。

例子:“A5: A50”

第一行:Row2

行范围

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

行名必须在一个列中。

例子:“25”

n

数量指标

使用正标量列索引指定包含行名的列。

例子:5

未指定或为空

指示没有行名。

例子:

数据类型:字符||

变量名的位置,指定为字符向量、字符串标量、正标量整数或空字符数组。指定VariableNamesRange作为该表中的值之一。

指定的 行为

“细胞”

使用Excel指定数据的起始单元格A1符号。例如,A5单元格的标识符是列的交叉点吗一个和行5

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

例子:的A5

Corner1: Corner2

矩形范围

使用矩形范围形式指定要读取的确切范围,其中Corner1Corner2是两个相对的角,它们定义了要读取的区域。

类中指定的列数必须匹配NumVariables属性,且范围必须仅跨一行。

例子:“A5: K5”

第一行:Row2

行范围

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

必须是单行。

例子:“5”

n

数量指标

使用正标量行索引指定包含变量名的行。

例子:5

未指定或为空

指示没有变量名。

例子:

数据类型:字符||

变量单位的位置,指定为字符向量、字符串标量、正标量整数或空字符数组。指定VariableUnitsRange作为该表中的值之一。

指定的 行为

“细胞”

使用Excel指定数据的起始单元格A1符号。例如,A5单元格的标识符是列的交叉点吗一个和行5

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

例子:的A5

Corner1: Corner2

矩形范围

使用矩形范围形式指定要读取的确切范围,其中Corner1Corner2是两个相对的角,它们定义了要读取的区域。

类中指定的列数必须匹配NumVariables属性,且范围必须仅跨一行。

例子:“A5: K5”

第一行:Row2

行范围

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

必须是单行。

例子:“5”

n

数量指标

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

例子:5

未指定或为空

表示没有可变单位。

例子:

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

变量描述的位置,指定为字符向量、字符串标量、正标量整数或空字符数组。指定VariableDescriptionRange作为该表中的值之一。

指定的 行为

“细胞”

使用Excel指定数据的起始单元格A1符号。例如,A5单元格的标识符是列的交叉点吗一个和行5

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

例子:的A5

Corner1: Corner2

矩形范围

使用矩形范围形式指定要读取的确切范围,其中Corner1Corner2是两个相对的角,它们定义了要读取的区域。

类中指定的列数必须匹配NumVariables属性,且范围必须仅跨一行。

例子:“A5: K5”

第一行:Row2

行范围

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

必须是单行。

例子:“5”

n

数量指标

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

例子:5

未指定或为空

指示没有变量描述。

例子:

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

仅用于文本文件的参数

全部折叠

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

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

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

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

过程来管理分隔文本文件中的前导分隔符,该分隔符作为本表中的值之一指定。

前导分隔符规则 行为
“保持” 保留分隔符。
“忽略” 忽略分隔符。
“错误” 返回错误并中止导入操作。

过程来管理带分隔符的文本文件中的尾随分隔符,该分隔符作为本表中的值之一指定。

前导分隔符规则 行为
“保持” 保留分隔符。
“忽略” 忽略分隔符。
“错误” 返回错误并中止导入操作。

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

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

数据类型:字符|字符串

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

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

例子:“空白”、“_”

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

行尾字符,指定为字符向量、字符串标量、字符向量的单元格数组或字符串数组。

例子:' LineEnding ', ' \ n '

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

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

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

与文件关联的字符编码方案,指定为逗号分隔的对,由“编码”“系统”或标准字符编码方案名称。

如果未指定任何编码,则该函数在读取文件时使用自动字符集检测来确定编码。

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

数据类型:字符|字符串

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

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

例子:CommentStyle,{“/ *”}

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

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

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

MATLAB持续时间数据类型

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

“文本”

如果“DurationType”指定为“文本”属性中指定的值,则导入的持续时间数据的类型取决于“TextType”参数:

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

  • 如果“TextType”设置为“字符串”,则导入函数以字符串数组的形式返回持续时间数据。

数据类型:字符|字符串

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

额外列规则 行为
“addvars”

要导入额外的列,请创建新变量。如果有N额外列,然后导入新变量为“ExtraVar1”、“ExtraVar2’,……、“ExtraVarN”.额外的数据列被导入,就像它们的VariableTypes字符

“忽略” 忽略额外的数据列。
“包装” 将额外的数据列包装到新记录中。这个操作不会改变变量的数量。
“错误” 显示错误消息并中止导入操作。

数据类型:字符|字符串

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

导入函数找到缺失的实例时,将使用MissingRule属性来确定适当的操作。

例子:TreatAsMissing,{“NA”,“TBD”}指示导入函数处理的任何事件NATBD作为一个缺失的领域。

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

用于读取日期的区域设置,指定为逗号分隔的对,由“DateLocale”和这种形式的字符向量或字符串标量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”

表示数值变量中千位分组的字符,指定为字符向量或字符串标量。数千个分组字符充当视觉分隔符,在每三个位置值处对数字分组。导入函数使用ThousandsSeparator属性解释正在导入的数字。

数据类型:字符|字符串

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

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

数据类型:字符|字符串

从指定为逻辑变量的数值变量中移除非数值字符真正的

数据类型:逻辑

输出数据类型为十六进制数据,指定为由逗号分隔的对组成“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)输入输出表。

数据类型:字符|字符串

仅限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和一个前缀数组。读取函数在计算XML文件上的XPath表达式时使用这些前缀。将命名空间前缀及其关联的url指定为Nx2字符串数组。RegisteredNamespaces也可以在计算由选择器名称-值参数指定的XPath表达式时使用,例如StructSelectorreadstruct,或VariableSelectorsreadtablereadtimetable

默认情况下,读取函数自动检测要注册的名称空间前缀,以便在XPath求值中使用,但是您也可以使用RegisteredNamespaces名称-值参数。当XML节点有名称空间URL,但在XML文件中没有声明名称空间前缀时,可以注册一个新的名称空间前缀。

例如,计算XML文件上的XPath表达式example.xml不包含名称空间前缀的。指定“RegisteredNamespaces”作为[" myprefix ", " //www.tatmou.com ")要分配前缀myprefix到URL//www.tatmou.com

T = readtable("example.xml", "VariableSelector", "/myprefix:Data",…"RegisteredNamespaces", ["myprefix", "//www.tatmou.com/au/"])

例子:“RegisteredNamespaces”,(“myprefix”、“//www.tatmou.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论点。

  • 如果VariableNamesRow0,则软件不导入变量名。

  • 否则,软件将从指定的行中导入变量名。

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

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

如果VariableUnitsRow0,则软件不导入变量单位。否则,软件将从指定的行中导入变量单元。

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

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

如果VariableDescriptionsRow0,则软件不导入变量描述。否则,软件将从指定的行中导入变量描述。

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

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

  • “跳过”—跳过空行。

  • “读”—读空行。

  • “错误”—在表检测时忽略空行,读取时出错。

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

  • “跳过”—跳过空列。

  • “读”—读取空列。

  • “错误”-在表检测和读取错误时忽略空列。

微软文档,HTML和XML文件

全部折叠

表数据XPath表达式,指定为字符向量或字符串标量,读取函数使用它来选择输出表数据。您必须指定TableSelector作为有效的XPath 1.0版表达式。

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

输出参数

全部折叠

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

提示

  • 创建导入选项对象后更新属性值:创建的导入选项对象的属性不建议使用点表示法detectImportOptions.使用点表示法设置属性时,MATLAB不会重新检测文件的所有导入选项。因此,要更新和重新检测所有属性,必须使用名称-值参数指定新值。的值ConsecutiveDelimitersRule属性,并按如下所示重新检测导入选项。

    opts = detectImportOptions(__,“ConsecutiveDelimitersRule”“加入”

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

    <数据> <表类别= "的" > < var > 1 < / var > < var > 2 < / var > < /表> <表类别= "十" > < var > 10 < / var > < var > 20 < / var > < /表> > < /数据
    该表提供了XPath选择器名称-值参数所支持的XPath语法,例如金宝appVariableSelectorsTableSelector

    选择操作 语法 例子 结果
    选择名称与要选择的节点匹配的每个节点,而不管其在文档中的位置。 在名称前加上两个斜杠(//).
    数据=可读数据(“myFile.xml”“VariableSelectors”' / / var '
    数据= 4×1表var ___ 1 2 10 20
    读取属于元素节点的属性的值。 在属性前加上@号(@).
    数据=可读数据(“myFile.xml”“VariableSelectors”' / /表/ @category '
    数据表categoryAttribute = 2×1  _________________ " 的”“十”
    在节点集中选择一个特定的节点。 在方括号中提供要选择的节点的索引([]).
    数据=可读数据(“myFile.xml”“TableSelector”/ /表[1]”
    数据= 2×1表var ___ 1 2
    指定操作的优先级。 在要首先求值的表达式周围添加圆括号。
    数据=可读数据(“myFile.xml”“VariableSelectors”/ /表/ var[1]”
    10 . Data = 2×1 table var ___ 1
    数据=可读数据(“myFile.xml”“VariableSelectors””(/ /表/ var)[1]”
    数据=表var ___

在R2016b中引入