根据文件内容创建导入选项
定位文件中的表并返回其导入选项。您可以修改options对象并使用它选择
= detectImportOptions (文件名
)readtable
如何控制MATLAB®导入表格数据。返回的选项类型取决于文件扩展名。例如,函数返回一个SpreadsheetImportOptions
如果对象文件名
是电子表格文件。然而,该函数返回一个DelimitedTextImportOptions
或FixedWidthImportOptions
如果对象文件名
是文本文件,还是XMLImportOptions
如果对象文件名
是XML文件,是HTMLImportOptions
如果对象文件名
是HTML文件,而WordDocumentImportOptions
如果对象文件名
是一个微软®词文档。
检测电子表格文件的导入选项,指定要导入的变量,然后读取数据。
从文件创建导入选项对象。
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
检查类型
变量的性质TaxiIn
和TaxiOut
.
getvaropts(选择,{“TaxiIn”,“TaxiOut”})
ans = 1x2 TextVariableImportOptions数组属性:名称类型FillValue TreatAsMissing QuoteRule Prefixes suffix EmptyFieldRule WhitespaceRule
改变变量的类型TaxiIn
和TaxiOut
来双
.
选项= 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
函数。通过设置指定从第二个表中读取TableIndex
来2
.
文件名=“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路径下的文件夹 | 中指定文件的名称 例子: |
||||||||
文件夹中的文件 |
如果文件不在当前文件夹或MATLAB路径上的文件夹中,则在中指定完整或相对路径名 例子: 例子: |
||||||||
互联网网址 | 如果文件指定为internet统一资源定位符(URL),则 例子: |
||||||||
远程位置 |
如果文件存储在远程位置,则
根据位置的远近
有关更多信息,请参见使用远程数据. 例子: |
如果文件名
然后,包括文件扩展名detectImportOptions
从扩展名确定文件格式。否则,必须指定“文件类型”
名称-值对来指示文件类型。
的detectImportOptions
函数支持以下文件扩金宝app展名:. txt
,.dat
,. csv
,xls
,.xlsb
,.xlsm
,.xlsx
,.xltm
,.xltx
,。ods
,. xml
,。docx
,. html
,名为. xhtml的
,. htm
.
请注意
文件扩展名.xlsb
和。ods
只在Excel平台金宝app上支持®对于Windows®.
数据类型:字符
|字符串
的可选逗号分隔对名称,值
参数。的名字
参数名称和价值
对应的值。的名字
必须出现在引号内。您可以以任意顺序指定多个名称和值对参数Name1, Value1,…,的家
.
“文件类型”、“表格”
文件类型
- - - - - -文件类型“表格”
|“文本”
|“delimitedtext”
|“fixedwidth”
|“xml”
|“worddocument”
|“html”
文件类型,指定为逗号分隔的对,由“文件类型”
其中一个值。
价值 | 文件导入选项 |
---|---|
“表格” |
返回一个 |
“文本” |
返回一个 |
“delimitedtext” |
返回一个 |
“fixedwidth” |
返回一个 |
“xml” |
返回一个 |
“worddocument” |
返回一个 |
“html” |
返回一个 |
使用“文件类型”
时的名称-值对参数文件名
不包括文件扩展名,或者扩展名不是以下类型之一:
. txt
,.dat
,或. csv
对于文本文件
xls
,.xlsb
,.xlsm
,.xlsx
,.xltm
,.xltx
,或。ods
电子表格文件
. xml
,适用于XML文件
。docx
为微软文字处理软件文档文件
. html
,名为. xhtml的
,或. htm
HTML文件
文件扩展名.xlsb
和。ods
只支持Excel 金宝appfor Windows平台。
例子:“文件类型”、“文本”
数据类型:字符
|字符串
TextType
- - - - - -导入文本数据的类型“字符”
|“字符串”
类型,指定为逗号分隔的对,由“TextType”
,要么“字符”
或“字符串”
.
“字符”
-将文本数据作为字符向量导入MATLAB。
“字符串”
-将文本数据导入MATLAB作为字符串数组。
例子:“TextType”、“生物炭”
DatetimeType
- - - - - -类型用于导入日期和时间数据“datetime”
(默认)|“文本”
|“exceldatenum”
(只适用于电子表格文件)类型导入的日期和时间数据,指定为逗号分隔的对,由“DatetimeType”
其中一个价值观是:“datetime”
,“文本”
,或“exceldatenum”
.的值“exceldatenum”
仅适用于电子表格文件,对文本文件无效。
价值 | 导入日期和时间数据的类型 |
---|---|
“datetime” |
MATLAB 有关更多信息,请参见 |
“文本” |
如果
|
“exceldatenum” |
Excel序列号 连续日期编号是与给定参考日期之后的天数相等的单个数字。Excel序列号与MATLAB序列号使用不同的参考日期。有关Excel日期的详细信息,请参见 |
数据类型:字符
|字符串
ReadVariableNames
- - - - - -将第一行读为变量名真正的
|假
指示符,用于将第一行读取为变量名,指定为逗号分隔的对,由“ReadVariableNames”
,要么真正的
或假
.如果未指定的,readtable
自动检测变量名的存在。
指示器 |
描述 |
---|---|
|
当要读取的区域的第一行包含表的变量名时使用。 |
|
当要读取的区域的第一行包含表中的数据时使用。 |
未指明的 | 如果不指定,导入函数将自动检测真正的 或假 并相应地进行。 |
数据类型:逻辑
VariableNamingRule
- - - - - -标记以保留变量名“修改”
(默认)|“保存”
标记以保留变量名,指定为任意一种“修改”
或“保存”
.
“修改”
-转换无效的变量名(由isvarname
函数)到有效的MATLAB标识符。
“保存”
-保留不是有效MATLAB标识符的变量名,例如包含空格和非ascii字符的变量名。
从R2019b开始,变量名和行名可以包含任何字符,包括空格和非ascii字符。此外,他们可以从任何字符开始,而不仅仅是字母。变量名和行名不必是有效的MATLAB标识符(由isvarname
功能)。若要保留这些变量名和行名,请设置值VariableNamingRule
来“保存”
.的值时,变量名不会刷新VariableNamingRule
从“修改”
来“保存”
.
数据类型:字符
|字符串
ReadRowNames
- - - - - -将第一列读取为行名的指示器假
(默认)|真正的
将第一列读取为行名的指示器,指定为逗号分隔的对,由“ReadRowNames”
,要么假
或真正的
.
指示器 |
描述 |
---|---|
|
当要读取的区域的第一列包含数据,而不是表的行名时使用。 |
|
当要读取的区域的第一列包含表的行名时使用。 |
未指明的 | 当未指定时,导入函数假定假 . |
数据类型:逻辑
MissingRule
- - - - - -过程来管理丢失的数据“填满”
(默认)|“错误”
|“omitrow”
|“omitvar”
过程来管理缺失的数据,该数据指定为本表中的值之一。
失踪的规则 | 行为 |
---|---|
“填满” |
的内容替换缺失的数据 的 |
“错误” |
停止导入并显示错误消息,显示丢失的记录和字段。 |
“omitrow” |
省略包含缺失数据的行。 |
“omitvar” |
省略包含缺失数据的变量。 |
例子:选择。MissingRule = 'omitrow';
数据类型:字符
|字符串
ImportErrorRule
- - - - - -过程来处理导入错误“填满”
(默认)|“错误”
|“omitrow”
|“omitvar”
过程来处理导入错误,该错误指定为本表中的值之一。
导入错误规则 | 行为 |
---|---|
“填满” |
类的内容替换发生错误的数据 的 |
“错误” |
停止导入并显示错误消息,显示导致错误的记录和字段。 |
“omitrow” |
省略发生错误的行。 |
“omitvar” |
省略发生错误的变量。 |
例子:选择。ImportErrorRule = 'omitvar';
数据类型:字符
|字符串
ExpectedNumVariables
- - - - - -期望变量数变量的预期数目,指定为由逗号分隔的对组成“ExpectedNumVariables”
一个正整数。如果未指定,导入函数将自动检测变量的数量。
数据类型:单
|双
NumHeaderLines
- - - - - -标题行数文件中的标题行数,由逗号分隔的对组成“NumHeaderLines”
一个正整数。如果未指定,导入函数将自动检测文件中的标题行数。
例子:“NumHeaderLines”7
数据类型:单
|双
范围
- - - - - -要读取的部分数据要从文本或电子表格文件中读取的数据的一部分,指定为由逗号分隔的对组成“范围”
以及这些形式之一的字符向量、字符串标量或数字向量。
指定方法范围 |
描述 |
---|---|
从细胞
|
将数据的起始单元格指定为字符向量或字符串标量或两个元素数值向量。
使用起始单元格,导入函数通过从起始单元格开始导入并在最后一个空行或页脚范围结束来自动检测数据的范围。 例子: |
矩形范围
|
使用其中一种形式的矩形范围指定要读取的确切范围。
导入函数只读取包含在指定范围内的数据。指定范围内的任何空字段都将作为缺失的单元格导入。 |
行范围或列范围
|
通过使用Excel行号标识开始行和结束行来指定范围。 使用指定的行范围,导入函数通过从第一个非空列读取数据的末尾来自动检测列的范围,并为每列创建一个变量。 例子: 或者,通过使用Excel列字母或数字标识开始列和结束列来指定范围。 使用指定的列范围,import函数通过从第一个非空行读取到数据末尾或页脚范围来自动检测行范围。 属性中指定的列数必须匹配 例子: |
起始行号
|
使用正标量行索引指定包含数据的第一行。 使用指定的行索引,导入函数通过从指定的第一行读入到数据的末尾或页脚范围来自动检测数据的范围。 例子: |
Excel的命名范围
|
在Excel中,可以创建名称来标识电子表格中的范围。例如,您可以选择电子表格的一个矩形部分并调用它 例子: |
未指定或为空
|
如果未指定,导入功能将自动检测使用范围。 例子: 注意:使用范围指电子表格中实际包含数据的矩形部分。导入函数通过修改不包含数据的任何开头和结尾行和列来自动检测所使用的范围。仅为空白的文本被认为是数据,并在使用的范围内捕获。 |
数据类型:字符
|字符串
|双
表
- - - - - -读取的表”
空字符数组(默认)|特征向量|字符串标量|正标量整数要从中读取的工作表,指定为空字符数组、字符向量或包含工作表名称的字符串标量,或表示工作表索引的正标量整数。属性指定的值表
属性时,导入函数的行为如表中所述。
规范 | 行为 |
---|---|
” (默认) |
从第一个工作表导入数据。 |
的名字 | 从匹配的工作表名称导入数据,而不管工作表在电子表格文件中的顺序如何。 |
整数 | 从表中导入由整数表示的位置的数据,而不管电子表格文件中的表名如何。 |
数据类型:字符
|字符串
|单
|双
DataRange
- - - - - -数据位置要导入的数据的位置,指定为字符向量、字符串标量、字符向量的单元格数组、字符串数组、正标量整数或N
——- - - - - -2
正标量整数数组。指定DataRange
使用这些形式之一
指定的 | 行为 |
---|---|
开始单元格或开始行 |
使用Excel指定数据的起始单元格 导入函数使用起始单元格自动检测数据的范围,方法是在起始单元格开始导入,并在最后一个空行或页脚范围结束导入。 或者,使用正标量行索引指定包含数据的第一行。 使用指定的行索引,导入函数通过从指定的第一行读入到数据的末尾或页脚范围来自动检测数据的范围。 例子: |
矩形范围 |
使用矩形范围形式指定要读取的确切范围,其中 导入函数只读取包含在指定范围内的数据。指定范围内的任何空字段都将作为缺失的单元格导入。 类中指定的列数必须匹配 例子: |
行范围或列范围 |
通过使用Excel行号标识开始行和结束行来指定范围。 使用指定的行范围,导入函数通过从第一个非空列读取数据的末尾来自动检测列的范围,并为每列创建一个变量。 例子: 或者,通过使用Excel列字母或数字标识开始列和结束列来指定范围。 使用指定的列范围,import函数通过从第一个非空行读取到数据末尾或页脚范围来自动检测行范围。 属性中指定的列数必须匹配 例子: |
多行范围 |
指定多行范围用英语阅读 由多个行范围组成的有效数组必须:
使用 例子: |
未指定或为空 |
不要获取任何数据。 例子: |
数据类型:字符
|字符串
|细胞
|单
|双
RowNamesRange
- - - - - -行名的位置”
空字符数组行名的位置,指定为字符向量、字符串标量、正标量整数或空字符数组。指定RowNamesRange
作为该表中的值之一。
指定的 | 行为 |
---|---|
|
使用Excel指定数据的起始单元格 导入函数为数据中的每个变量标识一个名称。 例子: |
矩形范围 |
使用矩形范围形式指定要读取的确切范围,其中 中包含的行数 例子: |
行范围 |
通过使用Excel行号标识开始行和结束行来指定范围。 行名必须在一个列中。 例子: |
数量指标 |
使用正标量列索引指定包含行名的列。 例子: |
未指定或为空 |
指示没有行名。 例子: |
数据类型:字符
|单
|双
VariableNamesRange
- - - - - -变量名的位置”
空字符数组变量名的位置,指定为字符向量、字符串标量、正标量整数或空字符数组。指定VariableNamesRange
作为该表中的值之一。
指定的 | 行为 |
---|---|
|
使用Excel指定数据的起始单元格 导入函数为数据中的每个变量读取一个名称。 例子: |
矩形范围 |
使用矩形范围形式指定要读取的确切范围,其中 类中指定的列数必须匹配 例子: |
行范围 |
通过使用Excel行号标识开始行和结束行来指定范围。 必须是单行。 例子: |
数量指标 |
使用正标量行索引指定包含变量名的行。 例子: |
未指定或为空 |
指示没有变量名。 例子: |
数据类型:字符
|单
|双
VariableUnitsRange
- - - - - -可变单元位置”
空字符数组变量单位的位置,指定为字符向量、字符串标量、正标量整数或空字符数组。指定VariableUnitsRange
作为该表中的值之一。
指定的 | 行为 |
---|---|
|
使用Excel指定数据的起始单元格 导入函数为数据中的每个变量读取一个单元。 例子: |
矩形范围 |
使用矩形范围形式指定要读取的确切范围,其中 类中指定的列数必须匹配 例子: |
行范围 |
通过使用Excel行号标识开始行和结束行来指定范围。 必须是单行。 例子: |
数量指标 |
使用正标量行索引指定包含数据单元的行。 例子: |
未指定或为空 |
表示没有可变单位。 例子: |
数据类型:字符
|字符串
|单
|双
VariableDescriptionsRange
- - - - - -变量描述的位置”
空字符数组变量描述的位置,指定为字符向量、字符串标量、正标量整数或空字符数组。指定VariableDescriptionRange
作为该表中的值之一。
指定的 | 行为 |
---|---|
|
使用Excel指定数据的起始单元格 导入函数读取数据中每个变量的描述。 例子: |
矩形范围 |
使用矩形范围形式指定要读取的确切范围,其中 类中指定的列数必须匹配 例子: |
行范围 |
通过使用Excel行号标识开始行和结束行来指定范围。 必须是单行。 例子: |
数量指标 |
使用正标量行索引指定包含描述的行。 例子: |
未指定或为空 |
指示没有变量描述。 例子: |
数据类型:字符
|字符串
|单
|双
分隔符
- - - - - -字段分隔符字符分隔文本文件中的字段分隔符字符,指定为字符向量、字符串标量、字符向量的单元格数组或字符串数组。
例子:“分隔符”,“|”
例子:“分隔符 ',{';','*'}
数据类型:字符
|字符串
|细胞
LeadingDelimitersRule
- - - - - -过程来管理前导分隔符“保持”
|“忽略”
|“错误”
过程来管理分隔文本文件中的前导分隔符,该分隔符作为本表中的值之一指定。
前导分隔符规则 | 行为 |
---|---|
“保持” |
保留分隔符。 |
“忽略” |
忽略分隔符。 |
“错误” |
返回错误并中止导入操作。 |
TrailingDelimitersRule
- - - - - -过程来管理尾随分隔符“保持”
|“忽略”
|“错误”
过程来管理带分隔符的文本文件中的尾随分隔符,该分隔符作为本表中的值之一指定。
前导分隔符规则 | 行为 |
---|---|
“保持” |
保留分隔符。 |
“忽略” |
忽略分隔符。 |
“错误” |
返回错误并中止导入操作。 |
ConsecutiveDelimitersRule
- - - - - -过程来处理连续的分隔符“分裂”
|“加入”
|“错误”
过程处理分隔文本文件中的连续分隔符,该分隔符指定为本表中的值之一。
连续分隔符规则 | 行为 |
---|---|
“分裂” |
将连续的分隔符拆分为多个字段。 |
“加入” |
将分隔符合并为一个分隔符。 |
“错误” |
返回错误并中止导入操作。 |
数据类型:字符
|字符串
VariableWidths
- - - - - -变量的字段宽度固定宽度文本文件中变量的字段宽度,指定为正整数值的向量。向量中的每个正整数对应于组成变量的字段中的字符数。的VariableWidths
属性中指定的每个变量对应的项VariableNames
财产。
空格
- - - - - -将字符视为空白要作为空白处理的字符,指定为包含一个或多个字符的字符向量或字符串标量。
例子:“空白”、“_”
例子:“空白”、“? !”
LineEnding
- - - - - -行尾字符{' \ n ', ' \ r ', ' \ r \ n '}
(默认)|特征向量|字符串标量|字符向量的单元格数组|字符串数组行尾字符,指定为字符向量、字符串标量、字符向量的单元格数组或字符串数组。
例子:' LineEnding ', ' \ n '
例子:“LineEnding”、“\ r \ n”
例子:LineEnding,{‘\ b’,‘:’}
数据类型:字符
|字符串
|细胞
编码
- - - - - -字符编码方案”
|“utf - 8”
|“系统”
|“iso - 8859 - 1”
|“windows - 1251”
|“windows - 1252”
|……与文件关联的字符编码方案,指定为逗号分隔的对,由“编码”
和“系统”
或标准字符编码方案名称。
如果未指定任何编码,则该函数在读取文件时使用自动字符集检测来确定编码。
例子:“编码”、“系统”
使用系统默认编码。
数据类型:字符
|字符串
CommentStyle
- - - - - -评论风格注释的样式,指定为字符向量、字符串标量、字符向量的单元格数组或字符串数组。
例如,要忽略同一行上百分号后面的文本,请指定CommentStyle
作为“%”
.
例子:CommentStyle,{“/ *”}
数据类型:字符
|字符串
|细胞
DurationType
- - - - - -持续时间数据的输出数据类型“持续时间”
(默认)|“文本”
文本文件中持续时间数据的输出数据类型,指定为由逗号分隔的对组成“DurationType”
,要么“持续时间”
或“文本”
.
价值 | 导入时长数据的类型 |
---|---|
“持续时间” |
MATLAB 有关更多信息,请参见 |
“文本” |
如果
|
数据类型:字符
|字符串
ExtraColumnsRule
- - - - - -过程来处理额外的列“addvars”
|“忽略”
|“包装”
|“错误”
过程处理数据中的额外列,这些列指定为本表中的值之一。
额外列规则 | 行为 |
---|---|
“addvars” |
要导入额外的列,请创建新变量。如果有 |
“忽略” |
忽略额外的数据列。 |
“包装” |
将额外的数据列包装到新记录中。这个操作不会改变变量的数量。 |
“错误” |
显示错误消息并中止导入操作。 |
数据类型:字符
|字符串
TreatAsMissing
- - - - - -要解释为缺失数据的文本要解释为缺失数据的文本,指定为字符向量、字符串标量、字符向量的单元格数组或字符串数组。
导入函数找到缺失的实例时,将使用MissingRule
属性来确定适当的操作。
例子:TreatAsMissing,{“NA”,“TBD”}
指示导入函数处理的任何事件NA
或TBD
作为一个缺失的领域。
数据类型:字符
|字符串
|细胞
DateLocale
- - - - - -阅读日期的地点用于读取日期的区域设置,指定为逗号分隔的对,由“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
- - - - - -表示千位分组的字符表示数值变量中千位分组的字符,指定为字符向量或字符串标量。数千个分组字符充当视觉分隔符,在每三个位置值处对数字分组。导入函数使用ThousandsSeparator
属性解释正在导入的数字。
数据类型:字符
|字符串
DecimalSeparator
- - - - - -表示十进制分隔符的字符表示数值变量中十进制分隔符的字符,指定为字符向量或字符串标量。导入函数使用DecimalSeparator
属性来区分数字的整数部分与小数部分。
当转换为整数数据类型时,具有小数部分的数字将四舍五入到最接近的整数。
数据类型:字符
|字符串
TrimNonNumeric
- - - - - -删除非数字字符假
(默认)|真正的
从指定为逻辑变量的数值变量中移除非数值字符真正的
或假
.
数据类型:逻辑
HexType
- - - - - -输出数据类型的十六进制数据“汽车”
(默认)|“文本”
|“int8”
|“int16”
|……输出数据类型为十六进制数据,指定为由逗号分隔的对组成“HexType”
和表中列出的值之一。
输入文件将十六进制值表示为文本,可以使用任意一种0 x
或0 x
作为前缀和字符0
-9
,一个
-f
,一个
-F
作为数字。(大写字母和小写字母代表相同的数字,例如,“0 xf”
和“0 xf”
两个代表15
.)
导入函数将十六进制值转换为的值指定的数据类型“HexType”
.
的价值 |
输出表变量的数据类型 |
---|---|
|
自动检测的数据类型 |
|
未修改的输入文本 |
|
8位整数,带符号 |
|
16位整数,带符号 |
|
32位整数,带符号 |
|
64位整数,有符号 |
|
8位整数,无符号 |
|
16位整数,无符号 |
|
32位整数,无符号 |
|
64位整数,无符号 |
例子:“HexType”、“uint16”
转换表示十六进制值的文本(例如“0 xff”
)到无符号16位整数(例如255
)输入输出表。
数据类型:字符
|字符串
BinaryType
- - - - - -二进制数据的输出数据类型“汽车”
(默认)|“文本”
|“int8”
|“int16”
|……输出数据类型为二进制数据,指定为由逗号分隔的对组成“BinaryType”
和表中列出的值之一。
输入文件将二进制值表示为文本,可以使用任意一种0 b
或0 b
作为前缀和字符0
和1
作为数字。
导入函数将二进制值转换为的值指定的数据类型“BinaryType”
.
的价值 |
输出表变量的数据类型 |
---|---|
|
自动检测的数据类型 |
|
未修改的输入文本 |
|
8位整数,带符号 |
|
16位整数,带符号 |
|
32位整数,带符号 |
|
64位整数,有符号 |
|
8位整数,无符号 |
|
16位整数,无符号 |
|
32位整数,无符号 |
|
64位整数,无符号 |
例子:“BinaryType”、“uint16”
转换表示二进制值的文本(例如“0 b11111111”
)到无符号16位整数(例如255
)输入输出表。
数据类型:字符
|字符串
ImportAttributes
- - - - - -导入属性1
或真正的
(默认)|逻辑0
或假
导入属性,指定为逗号分隔的对,由“ImportAttributes”
,要么1
(真正的
)或0
(假
).如果你指定假
,则读取函数不会将输入文件中的XML属性作为输出表中的变量导入。
例子:“ImportAttributes”,假的
AttributeSuffix
- - - - - -属性后缀“属性”
(默认)|特征向量|字符串标量属性后缀,指定为逗号分隔的对,由“AttributeSuffix”
或字符向量或字符串标量。此参数指定读取函数附加到与输入XML文件中的属性对应的所有表变量的后缀。如果您没有指定“AttributeSuffix”
,则读取函数默认为追加后缀“属性”
到与输入XML文件中的属性对应的所有变量名。
例子:“AttributeSuffix”、“_att”
RowNodeName
- - - - - -表行XML节点名称表行XML节点名,指定为由逗号分隔的对组成“RowNodeName”
或字符向量或字符串标量。此参数指定描述输出表行的XML节点名。
例子:“RowNodeName”、“XMLNodeName”
RowSelector
- - - - - -表行XPath表达式表行XPath表达式,指定为字符向量或字符串标量,读取函数使用它来选择输出表中的各个行。您必须指定RowSelector
作为有效的XPath 1.0版表达式。
例子:“RowSelector”、“RootNode / ChildNode”
VariableNodeNames
- - - - - -表变量XML节点名表变量XML节点名,指定为由逗号分隔的对组成“VariableNodeNames”
或者是字符向量的单元格数组,或者是字符串数组。此参数指定XML节点名,读取函数使用该名称标识要作为输出表中的变量读取的XML节点。
例子:VariableNodeNames,{‘XMLNodeName1’,‘XMLNodeName2}
例子:“VariableNodeNames”、“XMLNodeName”
例子:“VariableNodeNames”,(“XMLNodeName1”、“XMLNodeName2”)
VariableSelectors
- - - - - -表变量XPath表达式表变量XPath表达式,指定为字符向量的单元格数组或读取函数用来选择表变量的字符串数组。您必须指定VariableSelectors
作为有效的XPath 1.0版表达式。
例子:VariableSelectors, {' / RootNode / ChildNode '}
例子:‘VariableSelectors’,”/ RootNode / ChildNode”
例子:“VariableSelectors”,(“/ RootNode / ChildNode1”,“/ RootNode / ChildNode2”)
TableNodeName
- - - - - -表XML节点名表XML节点名,指定为逗号分隔的对,由“TableNodeName”
或字符向量或字符串标量。该参数指定了读取函数应该读取到表中的输入结构中的节点。
例子:“TableNodeName”、“节点名的
VariableUnitsSelector
- - - - - -变量单位XPath表达式变量单位XPath,指定为字符向量或字符串标量,读取函数使用它来选择表变量单位。您必须指定VariableUnitsSelector
作为有效的XPath 1.0版表达式。
例子:“VariableUnitsSelector”、“RootNode / ChildNode”
VariableDescriptionsSelector
- - - - - -变量描述XPath表达式变量描述XPath表达式,指定为字符向量或字符串标量,读取函数使用它来选择表变量描述。您必须指定VariableDescriptionsSelector
作为有效的XPath 1.0版表达式。
例子:“VariableDescriptionsSelector”、“RootNode / ChildNode”
RowNamesSelector
- - - - - -表行名XPath表达式表行名XPath表达式,指定为字符向量或字符串标量,读取函数使用该表达式选择表行的名称。您必须指定RowNamesSelector
作为有效的XPath 1.0版表达式。
例子:“RowNamesSelector”、“RootNode / ChildNode”
RepeatedNodeRule
- - - - - -过程来处理重复的XML节点“addcol”
(默认)|“忽略”
|“错误”
过程来处理表的给定行中重复的XML节点,指定为“addcol”
,“忽略”
,或“错误”
.
重复节点规则 |
行为 |
---|---|
“addcol” |
为表中变量标题下的重复节点添加列。指定的值 |
“忽略” |
跳过导入重复的节点。 |
“错误” |
显示错误消息并中止导入操作。 |
例子:“RepeatedNodeRule”、“忽略”
RegisteredNamespaces
- - - - - -已注册的XML名称空间前缀集一组已注册的XML名称空间前缀,指定为逗号分隔的对,由RegisteredNamespaces
和一个前缀数组。读取函数在计算XML文件上的XPath表达式时使用这些前缀。将命名空间前缀及其关联的url指定为Nx2字符串数组。RegisteredNamespaces
也可以在计算由选择器名称-值参数指定的XPath表达式时使用,例如StructSelector
为readstruct
,或VariableSelectors
为readtable
和readtimetable
.
默认情况下,读取函数自动检测要注册的名称空间前缀,以便在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”)
TableIndex
- - - - - -要读取的表的索引1
(默认)|正整数要读取的表的索引微软文字处理软件文档或HTML文件,包含多个表,指定为正整数。
当你指定TableIndex
,软件自动设置TableSelector
等价的XPath表达式。
数据类型:单
|双
|int8
|int16
|int32
|int64
|uint8
|uint16
|uint32
|uint64
MergedCellColumnRule
- - - - - -过程来处理合并列的单元格“placeleft”
(默认)|“placeright”
|“复制”
|“omitrow”
|“错误”
过程处理具有合并列的单元格,合并列指定为本表中的值之一。
导入错误规则 | 行为 |
---|---|
“placeleft” |
的内容填充在最左边的单元格中,并在剩余的单元格中填充 的 |
“placeright” |
将数据放置在最右边的单元格中,并用 的 |
“复制” |
复制所有单元格中的数据。 |
“omitrow” |
省略发生错误的行。 |
“错误” |
显示错误消息并中止导入操作。 |
MergedCellRowRule
- - - - - -过程来处理合并行的单元格“placeleft”
(默认)|“placeright”
|“复制”
|“omitrow”
|“错误”
过程处理带有合并行的单元格,合并行指定为本表中的值之一。
导入错误规则 | 行为 |
---|---|
“placetop” |
的内容填充剩余的单元格,并将数据放在顶部单元格中 的 |
“placebottom” |
将数据放置在底部单元格中,并用 的 |
“复制” |
复制所有单元格中的数据。 |
“omitvar” |
省略发生合并行的变量。 |
“错误” |
显示错误消息并中止导入操作。 |
VariableNamesRow
- - - - - -包含变量名的行包含变量名的行,指定为非负整数。
如果您没有指定VariableNamesRow
,然后软件读取变量名根据ReadVariableNames
论点。
如果VariableNamesRow
是0
,则软件不导入变量名。
否则,软件将从指定的行中导入变量名。
数据类型:单
|双
|int8
|int16
|int32
|int64
|uint8
|uint16
|uint32
|uint64
VariableUnitsRow
- - - - - -包含可变单位的行0
(默认)|非负整数包含变量单位的行,指定为非负整数。
如果VariableUnitsRow
是0
,则软件不导入变量单位。否则,软件将从指定的行中导入变量单元。
数据类型:单
|双
|int8
|int16
|int32
|int64
|uint8
|uint16
|uint32
|uint64
VariableDescriptionsRow
- - - - - -包含变量描述的行0
(默认)|非负整数包含变量描述的行,指定为非负整数。
如果VariableDescriptionsRow
是0
,则软件不导入变量描述。否则,软件将从指定的行中导入变量描述。
数据类型:单
|双
|int8
|int16
|int32
|int64
|uint8
|uint16
|uint32
|uint64
EmptyRowRule
- - - - - -规则应用于表中的空行“跳过”
(默认)|“读”
|“错误”
规则应用于表中的空行,指定为下列之一:
“跳过”
—跳过空行。
“读”
—读空行。
“错误”
—在表检测时忽略空行,读取时出错。
EmptyColumnRule
- - - - - -规则应用于表中的空列“跳过”
(默认)|“读”
|“错误”
规则应用于表中的空列,指定为下列之一:
“跳过”
—跳过空列。
“读”
—读取空列。
“错误”
-在表检测和读取错误时忽略空列。
TableSelector
- - - - - -表数据XPath表达式表数据XPath表达式,指定为字符向量或字符串标量,读取函数使用它来选择输出表数据。您必须指定TableSelector
作为有效的XPath 1.0版表达式。
例子:“TableSelector”、“RootNode / ChildNode”
选择
-导入文件选项SpreadsheetImportOptions
|DelimitedtextImportOptions
|FixedWidthImportOptions
|XMLImportOptions
导入指定文件的选项,返回为SpreadsheetImportOptions
,DelimitedTextImportOptions
,FixedWidthImportOptions
,或XMLImportOptions
对象。options对象的类型取决于指定的文件类型。对于文本文件(. txt
,.dat
,或. csv
),detectImportOptions
函数返回DelimitedTextImportOptions
或FixedWidthImportOptions
对象。电子表格档案(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 > < /表> > < /数据
VariableSelectors
或TableSelector
.
选择操作 | 语法 | 例子 | 结果 |
---|---|---|---|
选择名称与要选择的节点匹配的每个节点,而不管其在文档中的位置。 | 在名称前加上两个斜杠(// ). |
数据=可读数据(“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 ___ |
SpreadsheetImportOptions
|FixedWidthImportOptions
|DelimitedTextImportOptions
|XMLImportOptions
|WordDocumentImportOptions
|HTMLImportOptions
|readtable
你点击了一个对应于这个MATLAB命令的链接:
在MATLAB命令窗口中输入该命令来运行该命令。Web浏览器不支持MATLAB命令。金宝app
您也可以从以下列表中选择一个网站:
选择中国站点(中文或英文)以获得最佳站点性能。其他MathWorks国家站点没有针对您所在位置的访问进行优化。