主要内容

检测端口选项

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

描述

例子

选择=detectImportOptions(文件名在文件中定位表并返回其导入选项。您可以修改选项对象并使用它可阅读控制MATLAB的方式®导入表格数据。返回的选项类型取决于文件扩展名。例如,函数返回一个SpreadSheetimportOptions.反对如果文件名是一个电子表格文件。但是,该函数返回一个DelimitedTextImportOptionsFixedWidthImportOptions反对如果文件名是文本文件,还有一个文本文件XMLImportOptions反对如果文件名是XML文件。

例子

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

例子

全部折叠

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

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

opts = detectimportoptions(“patients.xls”
opts=具有属性的电子表格导入选项:工作表属性:工作表:“”替换属性:缺少规则:'fill'导入规则:'fill'变量导入属性:使用setvartype VariableNames按名称设置类型:{'LastName','Sevency','Age'。。。还有另外7个}变量类型:{'char','char','double'。。。还有7个}选择的变量名称:{'LastName','Gender','Age'。。。和7个以上}VariableOptions:显示所有10个VariableOptions使用setvaropts/getvaropts VariableNameGroup访问VariableOptions子属性:“修改”范围属性:DataRange:“A2”(起始单元格)VariableNameRange:“A1”RowNameRange:“VariableUnitsRange:”VariableDescriptionRange:“”若要显示表的预览,请使用preview

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

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

使用可阅读与options对象一起导入指定的变量。

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

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

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

opts = detectimportoptions(“airlinesmall.csv”
opts = DelimitedTextImportOptions with properties: Format properties: Delimiter:{','}空白:'\b\t ' LineEnding: {'\n' '\r' '\r\n'} CommentStyle: {} ConsecutiveDelimitersRule: 'split' LeadingDelimitersRule: 'keep' TrailingDelimitersRule: 'ignore' EmptyLineRule: 'skip' Encoding: 'ISO-8859-1'替换属性:missinggrule:'fill' ImportErrorRule: 'fill' ExtraColumnsRule: 'addvars'变量导入属性:使用setvartype VariableNames: {'Year', 'Month', 'DayofMonth'…{'double', 'double', 'double'…and 26 more} SelectedVariableNames: {'Year', 'Month', 'DayofMonth'…和26}VariableOptions:显示所有29 VariableOptions访问VariableOptions sub-properties使用setvaropts / getvaropts VariableNamingRule:“修改”位置属性:DataLines:[2正]VariableNamesLine: 1 RowNamesColumn: 0 VariableUnitsLine: 0 VariableDescriptionsLine: 0显示表的预览,预览使用

检查类型变量的性质出租车滑行

getvaropts(选择,{'滑行''滑行'})
ans=1x2 TextVariableImportOptions数组,具有以下属性:名称类型FillValue处理缺少引号前缀后缀EmptyFieldRule空白

更改变量的类型出租车滑行双重的

opts=setvartype(opts{'滑行''滑行'},“双”);

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

选择。SelectedVariableNames = {'滑行''滑行'};

使用可阅读函数与选项对象一起导入所选变量。显示表的摘要。

t = readtable(“airlinesmall.csv”、选择);总结(T)
变量:滑行输入:123523x1双倍值:最小0中位数5最大1451微调37383滑行输出:123523x1双倍值:最小0中位数13最大755微调37364

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

为文件创建选项对象。

opts = detectimportoptions('outages.csv');

指定要使用哪些变量可阅读,然后显示摘要。所选变量的数据类型为烧焦

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

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

opts = detectimportoptions('outages.csv'“文本类型”“字符串”);

指定要使用哪些变量可阅读,然后显示摘要。所选变量的数据类型为Now一串

选择。SelectedVariableNames = {“区域”“原因”}; T=可读性('outages.csv'、选择);总结(T)
变量:区域:1468x1字符串原因:1468x1字符串

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

创建一个XMLImportOptions对象从XML文件中删除。指定街道元素节点的值“可变选择器”,并注册前缀MyPrefix.的URL街道节点。

opts = detectimportoptions(“学生xml”“RegisteredNamespaces”,[“myprefix”“//www.tatmou.com”],...“VariableSelectors”“// myprefix:街道”
opts =具有属性的xmlimportoptions:replacement属性:迷失性:“fill”importerrule:“填充”repectednoderule:“addcol”变量导入属性:按名称使用setvartype variablenames设置类型:“street”variabletypes:“string”selectedvariablenames:“street”变量选项:显示所有1个变量选项访问变量选项使用setvaropts / getvaropts variablenamingrule:“preserve”位置属性:tableselector:<缺失> rowselector:<缺失> variableelectors:“// myprefix:street”变量单击:<缺失> variabledescriptions selector:<缺失> ROWNAMESSELECTOR:<缺失>注册NameSpaces:[“myprefix”“//www.tatmou.com”]

使用可阅读函数和options对象一起导入所选变量。

t2 =可读取的(“学生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
亚马逊S3™ s3
Windows Azure®Blob存储 黄蜂wasbs
HDFS™ hdfs

有关详细信息,请参阅使用远程数据

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

如果文件名然后包括文件扩展名检测端口选项根据扩展名确定文件格式。否则,必须指定“文件类型”用于指示文件类型的名称-值对。

检测端口选项函数支持这些文件扩金宝app展:.txt.dat.csv.xls..xlsb.xlsm.xlsx.xltm.xltx。ods,.xml.

请注意

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

数据类型:烧焦|一串

名称值对参数

指定可选的逗号分离对名称,价值论点。的名字参数名和价值为对应值。的名字必须出现在引号内。可以以任意顺序指定多个名称和值对参数name1,value1,...,namen,valuen

例子:'filetype','电子表格'
所有支持金宝app的文件类型

全部折叠

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

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

返回A.SpreadSheetimportOptions.对象。

'文本'

返回A.DelimitedTextImportOptionsFixedWidthImportOptions对象,具体取决于文本文件的布局。

“delimitedtext”

返回A.DelimitedTextImportOptions对象。对于列由分隔符分隔的文本文件使用此选项。

“fixedwidth”

返回A.FixedWidthImportOptions对象。对于列宽度固定的文本文件使用此选项。

“xml”

返回A.XMLImportOptions对象。使用此选项查找XML文件。

使用“文件类型”名称 - 值对参数何时文件名不包含文件扩展名,或者当扩展名不是其中之一时:

  • .txt.dat,或.csv对于文本文件

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

  • .xml.,用于XML文件

文件扩展名.xlsb。ods仅支持Excel 金宝appfor Windows平台。

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

数据类型:烧焦|一串

输入文本数据的类型,指定为逗号分隔对,由“文本类型”和任何一种'char'“字符串”

  • 'char'- 将文本数据导入MATLAB作为字符向量。

  • “字符串”- 将文本数据导入MATLAB作为字符串数组。

例子:“文本类型”,“字符”

输入导入日期和时间数据,指定为逗号分隔的配对'dateTimetype'其中一个价值观是:“datetime”'文本',或'ExceldateNum'.的值'ExceldateNum'仅适用于电子表格文件,对文本文件无效。

价值 输入导入日期和时间数据
“datetime”

MATLAB约会时间数据类型

有关详细信息,请参阅约会时间

'文本'

如果'dateTimetype'被指定为'文本',则导入的日期和时间数据的类型取决于“文本类型”参数:

  • 如果“文本类型”被设定为'char',然后导入函数将日期返回为字符向量的单元格数组。

  • 如果“文本类型”被设定为“字符串”,则导入函数以字符串数组的形式返回日期。

'ExceldateNum'

Excel序列日期编号

序列号是一个单独的数字,等于从给定的参考日期开始的天数。Excel串行日期数字使用不同的参考日期比MATLAB串行日期数字。有关Excel日期的更多信息,请参见https://金宝appsupport.microsoft.com/en-us/kb/214330

数据类型:烧焦|一串

用于读取第一行的指示器作为变量名称,指定为包括的逗号分隔对“ReadVariableNames”和任何一种真正的.如果未指定,可阅读自动检测变量名的存在。

指标

描述

真正的

使用当要读取的区域的第一行包含表中的变量名称。可阅读为每个列创建一个具有检测到的变量名的变量T.

当要读取的第一行包含表中的数据时使用。可阅读创建表单的默认变量名称'var1',......,'varn'哪里N是变量的数量。

未指明 当未指定时,导入函数自动检测真正的并据此进行。

数据类型:逻辑

保留变量名的标志,指定为逗号分隔对,由VariableNamingRule和任何一种'调整'“保存”

  • '调整'- 转换无效的变量名称(由此确定)isvarname函数)的有效MATLAB标识符。

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

从R2019B开始,变量名称和行名可以包含任何字符,包括空格和非ASCII字符。此外,它们可以从任何角色开始,而不仅仅是字母。变量和行名不必是有效的matlab标识符(由此确定)isvarname功能)。要保留这些变量名称和行名称,请设置值VariableNamingRule“保存”

数据类型:烧焦|一串

用于将第一列作为行名读取的指示符,指定为逗号分隔对,由“ReadRowNames”和任何一种真正的

指标

描述

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

真正的

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

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

数据类型:逻辑

过程来管理丢失的数据,该数据指定为该表中的一个值。

失踪的规则 行为
“填充”

将缺少的数据替换为fillvalue.财产。

fillvalue.属性中指定可变端口选项正在导入变量的对象。有关访问的更多信息fillvalue.财产,参见getvaropts

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

例子:选择opts.missingrule ='欧洲';

数据类型:烧焦|一串

处理导入错误的过程,指定为此表中的一个值。

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

替换错误发生错误的数据fillvalue.财产。

fillvalue.属性中指定可变端口选项正在导入变量的对象。有关访问的更多信息fillvalue.财产,参见getvaropts

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

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

数据类型:烧焦|一串

文本和电子表格文件

全部折叠

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

数据类型:|双重的

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

例子:'numheaderlines',7

数据类型:|双重的

要从文本或电子表格文件中读取的部分数据,指定为由逗号分隔的对组成'范围'和其中一个表单中的字符向量,字符串标量或数字矢量。

指定的方法范围 描述

从细胞

“细胞”[行col]

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

  • 字符向量或字符串标量,包含excel的列字母和行号A1符号。例如,A5单元格的标识符是否位于列的交点一种和排5.

  • 形式的二元数值向量[行col]表示起始行和列。

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

例子:的A5(5 - 1)

矩形范围

'Corner1:Corner2'[r1 c1 r2 c2]

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

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

  • [r1 c1 r2 c2]—使用包含start-row、start-column、end-row和end-column的四个元素的数字向量指定范围。例如,[2 3 15 13]

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

行范围或列范围

'row1:row2'“Column1: Column2”

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

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

例子:'5:500'

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

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

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

例子:'A:K'

起始行号

N

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

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

例子:5.

Excel的命名范围

“NamedRange”

在Excel中,您可以创建名称以识别电子表格中的范围。例如,您可以选择电子表格的矩形部分并调用它“myTable”.如果在电子表格中存在此类命名范围,则导入功能可以使用其名称读取该范围。

例子:'范围','mytable'

不明或空

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

例子:“范围”

笔记:使用范围指电子表格中实际包含数据的矩形部分。导入函数通过修剪不包含数据的任何前导行和尾随行和列,自动检测使用的范围。仅为空白的文本被视为数据,并在使用范围内捕获。

数据类型:烧焦|一串|双重的

仅电子表格文件的参数

全部折叠

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

规范 行为
(默认) 从第一张作为导入数据。
的名字 从匹配的图纸名称导入数据,而不考虑图纸在电子表格文件中的顺序。
整数 无论电子表格文件中的工作表名称如何导入由整数的位置的页面导入数据。

数据类型:烧焦|一串||双重的

要导入的数据的位置,指定为字符向量、字符串标量、字符向量的单元数组、字符串数组、正标量整数或N-借-2正标量整数数组。指定数据范围使用其中一种形式。

指定的 行为

“细胞”N

起始牢房或起始行

使用Excel指定数据的起始单元格A1符号。例如,A5单元格的标识符是否位于列的交点一种和排5.

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

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

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

例子:的A55.

'角落1:Corner2.'

矩形范围

使用矩形范围窗体指定要读取的精确范围,其中Corner1Corner2是定义要读取的区域的两个相反的角。

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

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

例子:“A5: K50”

'第1行:第2行''第1列:Column2.'

行范围或列范围

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

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

例子:'5:500'

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

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

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

例子:'A:K'

[n1 n2;n3 n4; ...]

多个行范围

指定多个行范围用铅笔阅读N-借-2数组包含N不同的行范围。

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

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

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

使用INF.仅支持指示指定多金宝app个行范围的数字数组中的最后一个范围。例如,[1 3;5 6;8款]

例子:[1 3;5 6;8款]

不明或空

不要获取任何数据。

例子:

数据类型:烧焦|一串|细胞||双重的

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

指定的 行为

“细胞”

使用Excel指定数据的起始单元格A1符号。例如,A5单元格的标识符是否位于列的交点一种和排5.

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

例子:的A5

'角落1:Corner2.'

矩形范围

使用矩形范围窗体指定要读取的精确范围,其中Corner1Corner2是定义要读取的区域的两个相反的角。

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

例子:'A5:A50'

'第1行:第2行'

行范围

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

行名必须在单个列中。

例子:“25”

N

数量指标

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

例子:5.

不明或空

指示没有行名。

例子:

数据类型:烧焦||双重的

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

指定的 行为

“细胞”

使用Excel指定数据的起始单元格A1符号。例如,A5单元格的标识符是否位于列的交点一种和排5.

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

例子:的A5

'角落1:Corner2.'

矩形范围

使用矩形范围窗体指定要读取的精确范围,其中Corner1Corner2是定义要读取的区域的两个相反的角。

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

例子:‘A5:K5’

'第1行:第2行'

行范围

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

必须是单行。

例子:“5”

N

数量指标

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

例子:5.

不明或空

表示没有变量名称。

例子:

数据类型:烧焦||双重的

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

指定的 行为

“细胞”

使用Excel指定数据的起始单元格A1符号。例如,A5单元格的标识符是否位于列的交点一种和排5.

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

例子:的A5

'角落1:Corner2.'

矩形范围

使用矩形范围窗体指定要读取的精确范围,其中Corner1Corner2是定义要读取的区域的两个相反的角。

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

例子:‘A5:K5’

'第1行:第2行'

行范围

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

必须是单行。

例子:“5”

N

数量指标

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

例子:5.

不明或空

表示没有可变单元。

例子:

数据类型:烧焦|一串||双重的

变量描述的位置,指定为字符向量、字符串标量、正标量整数或空字符数组。具体说明variabledescrectionrange.作为此表中的值之一。

指定的 行为

“细胞”

使用Excel指定数据的起始单元格A1符号。例如,A5单元格的标识符是否位于列的交点一种和排5.

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

例子:的A5

'角落1:Corner2.'

矩形范围

使用矩形范围窗体指定要读取的精确范围,其中Corner1Corner2是定义要读取的区域的两个相反的角。

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

例子:‘A5:K5’

'第1行:第2行'

行范围

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

必须是单行。

例子:“5”

N

数量指标

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

例子:5.

不明或空

指示没有变量描述。

例子:

数据类型:烧焦|一串||双重的

仅限文本文件的参数

全部折叠

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

例子:'delimiter','|'

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

数据类型:烧焦|一串|细胞

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

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

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

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

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

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

数据类型:烧焦|一串

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

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

例子:'空白','_'

例子:'空白','!!。,'

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

例子:' LineEnding ', ' \ n '

例子:'系列','\ r \ n'

例子:'排队',{'\ b',':'}

数据类型:烧焦|一串|细胞

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

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

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

数据类型:烧焦|一串

评论的风格,指定为字符向量,字符串标量,字符向量或字符串数​​组。

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

例子:'CommentStyle',{'/*'}

数据类型:烧焦|一串|细胞

文本文件中持续时间数据的输出数据类型,指定为逗号分隔对,由“DurationType”和任何一种“持续时间”'文本'

价值 输入导入持续时间数据
“持续时间”

MATLAB持续时间数据类型

有关详细信息,请参阅持续时间

'文本'

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

  • 如果“文本类型”被设定为'char'然后,导入函数将持续时间数据返回为字符向量的小区数组。

  • 如果“文本类型”被设定为“字符串”,则导入函数将持续时间数据作为字符串数组返回。

数据类型:烧焦|一串

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

额外列规则 行为
'addvars'

要导入额外的列,请创建新变量。如果有N额外列,然后导入新变量作为'Extravar1','Extravar2',......,'extravarn'

注意:额外的列作为具有数据类型的文本导入文本烧焦

'忽略' 忽略额外的数据列。
'裹' 将额外的数据列包到新记录。此操作不会更改变量的数量。
'错误' 显示错误消息并中止导入操作。

数据类型:烧焦|一串

文本以将指定为缺少数据的文本,指定为字符向量,字符串标量,字符向量单元数组或字符串数​​组。

当导入函数发现缺失的实例时,它将使用该规范丢失规则属性来确定适当的操作。

例子:“尾声”,{'na','tbd'}指示导入功能治疗任何发生NA.待定作为缺少的领域。

数据类型:烧焦|一串|细胞

读取日期的区域设置,指定为逗号分隔对,由“DateLocale”以及表单的字符矢量或字符串标量xx_YY,地点:

  • YY是一个大写ISO 3166-1 Alpha-2代码,指示一个国家。

  • xx是一种表示语言的小写ISO 639-1双字母代码。

有关区域设置的常见值列表,请参阅语言环境的名称-值对参数约会时间功能。

当使用% D格式化说明符以读取文本约会时间值,使用datelocale.指定导入函数应该解释月份和日常名称和缩写的语言环境。

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

例子:“DateLocale”、“ja_JP”

以数字变量表示千分组的字符,指定为字符向量或字符串标量。数千个分组字符充当可视分隔符,将数字按每三个位置值分组。导入函数使用千分之二属性来解释所导入的数字。

数据类型:烧焦|一串

在数字变量中指示十进制分隔符的字符,指定为字符向量或字符串标量。导入函数使用decimalseparator.属性以将数字的整数部分与十进制部分区分开来。

转换为整数数据类型时,带有十进制部分的数字将舍入到最接近的整数。

数据类型:烧焦|一串

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

数据类型:逻辑

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

输入文件将十六进制值表示为文本,使用其中之一0 x0 x作为前缀和字符0.-9.一种-F,一种-F作为数字。(大写字母和小写字母代表相同的数字,例如,'0xF'“0xF”两个代表15.)

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

的价值“HexType”

输出表变量的数据类型

'汽车'

自动检测的数据类型

'文本'

未改变输入文本

'int8'

8位整数,有符号

“int16”

16位整数,签名

“int32”

32位整数,签署了

“int64”

64位整数,签名

'uint8'

8位整数,无符号

“uint16”

16位整数,无符号

'uint32'

32位整数,无符号

'uint64'

64位整数,无符号

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

数据类型:烧焦|一串

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

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

的值指定的数据类型“二进制类型”

的价值“二进制类型”

输出表变量的数据类型

'汽车'

自动检测的数据类型

'文本'

未改变输入文本

'int8'

8位整数,有符号

“int16”

16位整数,签名

“int32”

32位整数,签署了

“int64”

64位整数,签名

'uint8'

8位整数,无符号

“uint16”

16位整数,无符号

'uint32'

32位整数,无符号

'uint64'

64位整数,无符号

例子:'binarytype','uint16'转换表示二进制值的文本(例如'0B11111111')到无符号16位整数(例如255.)在输出表中。

数据类型:烧焦|一串

仅限XML文件

全部折叠

导入属性,指定为逗号分隔对,由'进一步进一步'和任何一种1真正的) 或者0.)。如果您指定,则读取函数将不会将输入文件中的XML属性作为输出表中的变量导入。

例子:'进口进一步',false

属性后缀,指定为逗号分隔对组成“AttributeSuffix”和字符向量或字符串标量。此参数指定读取函数附加到与输入XML文件中的属性相对应的所有表变量的后缀。如果您没有指定“AttributeSuffix”,然后读取功能默认为追加后缀“属性”对于对应于输入XML文件中的属性的所有变量名称。

例子:“AttributeSuffix”、“_att”

表行XML节点名称,指定为逗号分隔对组成“RowNodeName”或者是字符向量或者是字符串标量。此参数指定描述输出表行的XML节点名。

例子:“RowNodeName”、“XMLNodeName”

表行XPath表达式,指定为读取函数用于选择输出表各行的字符向量或字符串标量。您必须指定RowSelector作为有效的XPath 1.0版本表达式。

例子:“行选择器”,“/RootNode/ChildNode”

表变量XML节点名,指定为逗号分隔对,由“VariableNodeNames”字符向量的单元格数组或字符串数组。此参数指定读取函数用于标识要在输出表中读取的XML节点的XML节点名。

例子:'variablenodenames',{'xmlnodename1','xmlnodename2'}

例子:'variablenodenames',“xmlnodename”

例子:'VariableNodeNames',[“XMLNodeName1”,“XMLNodeName2”]

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

例子:'VariablingElectors',{'/ rootnode / shildnode'}

例子:“VariableSelectors”,“/RootNode/ChildNode”

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

表XML节点名称,指定为逗号分隔对“TableNodeName”和字符向量或字符串标量。此参数指定输入结构中读取函数应读取到表中的节点。

例子:'tablenodename','nodename'

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

例子:“表选择器”,“/RootNode/ChildNode”

变量单位XPath,指定为读取函数用于选择表变量单位的字符向量或字符串标量。您必须指定变量单独选择作为有效的XPath 1.0版本表达式。

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

变量描述XPath表达式,指定为字符向量或字符串标量,read函数读取时使用它来选择表变量描述。您必须指定VariableDescriptionsSelector作为有效的XPath 1.0版本表达式。

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

表行名XPath表达式,指定为字符向量或字符串标量,读取函数使用它来选择表行的名称。您必须指定RowNamesSelector作为有效的XPath 1.0版本表达式。

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

处理表中给定行中重复的XML节点的过程,指定为'addcol''忽略',或'错误'

重复节点规则

行为

'addcol'

为表中变量标题下的重复节点添加列。指定的值“RepeatedNodeRule”作为'addcol'在表中没有在表中为重复节点创建单独的变量。

'忽略'

跳过导入重复的节点。

'错误' 显示错误消息并中止导入操作。

例子:“重复节点”和“忽略”

已注册的XML名称空间前缀集,指定为逗号分隔对,由RegisteredNamespaces和一系列前缀。读取函数在XML文件上评估XPath表达式时使用这些前缀。将命名空间前缀及其关联的URL指定为NX2字符串数组。RegisteredNamespaces也可以在计算选择器名称-值参数指定的XPath表达式时使用,例如structSelector.readstruct,或VariableSelectors可阅读ReadTimetable.

默认情况下,reading函数自动检测要注册以在XPath计算中使用的名称空间前缀,但也可以使用RegisteredNamespaces名称值参数。当XML节点具有命名空间URL时,您可能会注册新的命名空间前缀,但XML文件中没有声明的命名空间前缀。

例如,在名为example.xml.不包含命名空间前缀的。具体说明“RegisteredNamespaces”作为[“MyPrefix”,“//www.tatmou.com”]分配前缀myprefix到URL//www.tatmou.com

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

例子:'RegisteredNamespaces',[“myprefix”,“//www.tatmou.com”]

输出参数

全部折叠

导入指定文件的选项,返回为SpreadSheetimportOptions.DelimitedTextImportOptionsFixedWidthImportOptions,或XMLImportOptions对象。选项对象的类型取决于指定的文件类型。文本档案(.txt.dat,或.csv), 这检测端口选项函数返回A.DelimitedTextImportOptionsFixedWidthImportOptions对象。电子表格档案(.xls..xlsb.xlsm.xlsx.xltm.xltx,或。ods), 这检测端口选项函数返回A.SpreadSheetimportOptions.对象。对于XML文件(.xml.),检测端口选项返回A.XMLImportOptions对象。

提示

  • 创建导入选项对象后更新属性值:由创建的导入选项对象的属性不建议使用点表示法软化物选项.使用点表示法设置属性时,MATLAB不会重新检测文件的所有导入选项。因此,要更新和重新检测所有属性,必须使用名称值参数来指定新值。例如,更新值的值连续寿命皆宜属性并重新检测导入选项,如下所示。

    opts = detectimportoptions(__,'Consecutivedelimitersrule''加入'

  • XPath选择器名称值参数支持以下XPath语法,例如金宝appRowSelectorVariableSelector

    • 要选择名称与要选择的节点相匹配的每个节点,无论其在文档中的位置如何,请使用“// mynode”语法。您可以使用“// mynode”省略要选择的节点之前的XPath表达式。

    • 要读取文件中一个父节点下的几个同级节点中的一个,可以指定ChildNode [N]哪里N对应于要索引的同级节点。例如,路径“/ RootNode / ChildNode[2]”选择第二个儿童潮流父母的元素扎根

    • 要读取输入XML文件中属于元素节点的属性值,请指定@在属性名称之前。例如,“/ RootNode / ChildNode [2] / @AttributeName”选择属性attributename.属于第二种儿童潮流父母的元素扎根

介绍在R2016B.