主要内容

readtimetable

从文件创建时间表

描述

例子

TT= READTIMETABLE(文件名通过从文件读取面向列的数据来创建时间表。

readtimetable确定从文件扩展名的文件格式:

  • 。文本.DAT,或. csv用于分隔文本文件

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

  • . xml用于可扩展标记语言(XML)文件。

对于文本和电子表格文件,readtimetable创建一个变量TT读取文件的每一列,并从文件的第一行读取变量名。XML文件,readtimetable创建一个变量T.对于检测到作为时间变量的每个元素或属性节点。变量名称对应于元素和属性名称。

readtimetable设置类型的第一列datetime期间在表格数据中,是时间表的行时间。剩下的列变成时间表的变量。

例子

TT= READTIMETABLE(文件名选择另外使用导入选项选择

例子

TT= READTIMETABLE(___名称,价值创建从与由一个或多个名称值对的参数指定的附加选项的文件的时间表。指定名称 - 值对之前使用任何从以前的语法输入参数。

要为数据设置特定的导入选项,可以使用选择对象或您可以指定名称值对。除了添加名称 - 值对时选择, 然后readtimetable万博1manbetx仅支持这些名称 - 值对:

  • 文本和电子表格参数ReadVariableNamesRowTimesSampleRate时间戳开始时间

  • 文字参数-DateLocale编码

  • 仅电子表格参数-meftexcel.

例子

全部收缩

从逗号分隔文本文件中创建一个表。

TT = readtimetable (“outages.csv”);

显示表的汇总。当创建一个时间表,如果你不为行时间指定任何参数,那么readtimetable函数检测并指定数据中的第一个datetime或duration变量,OutageTime,作为行乘以变量。剩下的变量成为时间表的变量。

总结(TT)
Rowtims:OutageTime:1468x1 DateTime值:Min 2002-02-01 12:18中位数2010-03-18 21:05 Max 2014-01-15 02:41变量:区域:1468x1 Cell are字符矢量丢失:1468x1双值:Min 0中位数180.26 Max 23418 Nummissing 604客户:1468x1双倍值:Min 0中位数75765 Max 5.9689E + 06 Nummissing 328 Restiontime:1468x1 DateTime值:Min 2002-02-07 16:50中位数2010-03-31 10:54MAX 2042-09-18 23:31 NUMMISING 29原因:1468x1字符向量阵列

检测导入选项的文本文件,指定变量的类型,然后根据数据创建一个时间表。

从文件创建导入选项对象并检查变量选项。

选择= detectImportOptions (“outages.csv”);选择。VariableOptions
ANS = 1X6异构VariableImportOptions(TextVariableImportOptions,DatetimeVariableImportOptions,NumericVariableImportOptions)阵列具有属性:名称类型FillValue TreatAsMissing QuoteRule前缀后缀EmptyFieldRule

修改options对象以为数据中的变量指定所需的数据类型。更改变量的数据类型地区原因分类。

选择= setvartype(选择,{“地区”'原因'},{“分类”“分类”});

readtimetable以及用于导入时间表的options对象。然后显示时间表的摘要。

TT = readtimetable (“outages.csv”、选择);总结(TT)
RowTimes:OutageTime:1468x1 datetime值:闵2002-02-01 12:18中位数2010-03-18 21:05马克斯2014年1月15日02:41变量:地区:1468x1分类值:中西部142东北地区东南557西南38926西354损耗:1468x1双重价值:最小0中位180.26最多23418 NumMissing 604个客户:1468x1双重价值:最小0中位数75765最大5.9689e + 06 NumMissing 328 RestorationTime:1468x1 datetime值:最小2002年2月7日16:50中位数2010-03-31 10:54马克斯2042年9月18日23:31 NumMissing 29原因:1468x1分类值:攻击294地震2能源告急188设备故障156火警25强风暴338雷暴201未知24风95冬季风暴145

从逗号分隔文本文件中读取一个表,并创建您选择的排次变量的时间表。

创建导入选项对象并预览表格数据。

选择= detectImportOptions (“outages.csv”);预览(“outages.csv”选择)
ans =8×6表地区OutageTime RestorationTime造成损失客户  _____________ ________________ ______ __________ ________________ ___________________ {' 西南的}2002-02-01 12:18 458.98 - 1.8202 e + 06 2002-02-01 16:50{“暴风雪”}{“东南”}2003-01-23 00:49 530.14 - 2.1204 e + 05 NaT{“暴风雪”}{“东南”}2003-02-07)21:15 289.4 - 1.4294 e + 052003-02-17 08:14 {'winter storm'} {'West'} 2004-04-06 05:44 434.81 3.4037e+05 2004-04-06 06:10 {'equipment fault'} {'MidWest'} 2002-03-16 06:18 186.442002-06-06 19:28 311.86 NaN 2002-06-07 00:51{'设备故障'}

通过指定来创建时间表RestorationTime变量是时间表的行时间变量。然后,显示时间表的摘要。

TT = readtimetable (“outages.csv”'rowtimes'“RestorationTime”);总结(TT)
Rowtims:1468x1 DateTime值:Min 2002-02-07 16:50中位数2010-03-31 10:54 Max 2042-09-18 23:31 Nummissing 29变量:区域:1468x1单元格数量向量超声:1468x1DATETIME值:MIN 2002-02-01 12:18中位数2010-03-18 21:05 MAX 2014-01-15 02:41损失:1468x1双重值:min 0中位数180.26 MAX 23418 Nummissing 604客户:1468x1双值:MIN 0中位数75765 MAX 5.9689E + 06 Nummissing 328原因:1468x1 Cell ark of Character Vors

创建电子表格文件的时间表和格式化输入数据。例如,创建该文件的时间表quarterlyFinances1999To2019.csv,指定时间戳的开始日期和它们之间的时间,并从数据中删除“$”符号。

读取文件中的数据quarterlyFinances1999To2019.csv作为时间表。在1999年1月1日开始的日期开始指定连续行时间之间的时间长度为一个日历季度。'preservevariablenames'真正的保留变量名中的空格,并设置'TrimNonNumeric'真正的在数据的数值之前删除“$”符号。

TT = readtimetable (“quarterlyFinances1999To2019.csv”“时间步”,calquarters(1),“开始时间”,日期时间(1999年,1,1),...“PreserveVariableNames”, 真的,“TrimNonNumeric”,真正的);

显示数据的摘要。

总结(TT)
RowTimes: Time: 80x1 datetime值:Min 01- 1月1999年1月16日-2008年11月16日Max 01- 10月2018年变量:净销售额:80x1 double值:Min 35066中位数1.0407e+05 Max 1.7684e+05销售成本:80x1 double值:Min 18106中位数48624 Max 77742毛利:80x1 double值:Min 14563中位数56719 Max 99097研发费用:80x1 double Values: Min 4904.9中位数24637 Max 45234行政费用:80x1 double Values: Min 1047.4中位数2015.3 Max 2811.5总运营费用:80x1 double Values: Min 5992.5中位数26518 Max 48045净收入:80x1 double Values: Min 7634.3中位数28586 Max 51051总股份:80x1 double Values:最小822中位数1820.5最大值2710每股收益:80x1双值:最小6.52中位数15.515最大值24.62

输入参数

全部收缩

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

根据你的文件的位置,文件名可以采取其中一种形式。

地点

形式

在MATLAB当前文件夹或文件夹®小路

中指定文件的名称文件名

例子:'MYFILE.TXT'

文件的文件夹中

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

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

例子:'datadir \ myfile.txt'

互联网网址

如果文件被指定为互联网统一资源定位符(URL),然后文件名必须包含协议类型的 'http://''https://'

例子:'http://hostname/path_to_file/my_data.csv'

偏远的地点

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

scheme_name://文件路径/my_file.ext

基于远程位置,scheme_name可以是该表中的值之一。

偏远的地点 scheme_name
亚马逊S3™ s3
Windows Azure.®Blob存储 wasbwasbs
HDFS™ hdfs

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

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

  • 如果文件名包括文件扩展名,然后导入函数从扩展名确定文件格式。否则,您必须指定'文件类型'名称 - 值对参数指示文件类型。

  • 在Windows上®与微软的系统®Excel®软件,进口函数读取您的Excel版本认可的Excel电子表格文件格式。

  • 如果您的系统没有Excel for Windows,或者您正在使用MATLAB在线™,导入功能与该功能一起运行meftexcel.属性设置为错误的,只有读.xls、.xlsx、.xlsm、.xltx和.xltm文件。

  • 对于带分隔符的文本文件,导入函数将文件中的空字段转换为任意一种(对于数值变量)或空字符向量(对于文本变量)。文本文件中的所有行必须具有相同数量的分隔符。导入函数忽略文件中不重要的空白。

数据类型:char|字符串

文件导入选项,指定为一个SpreadsheetImportOptionsDelimitedTextImportOptionsFixedWidthImportOptions,或XMLImportOptions目的是通过创建detectImportOptions功能。这选择对象包含控制数据导入过程的性质。有关每个对象的属性的详细信息,请参阅相应对象的页面。

文件类型 输出
电子表格文件 SpreadsheetImportOptions对象(仅适用于DataRange,variablenames.属性)
文本文件 DelimitedTextImportOptions目的
固定宽度文本文件 FixedWidthImportOptions目的
XML文件 XMLImportOptions目的

名称-值对的观点

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

例子:'numheaderlines',5指示表格数据前面的前五行是标题行。
文本和电子表格文件

全部收缩

文件类型,指定为逗号分隔对组成'文件类型'“文本”“表格”

指定'文件类型'名称 - 值对的参数,当文件名不包括文件扩展名或扩展名是以下之一:

  • 。文本.DAT,或. csv用于分隔文本文件

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

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

数据类型:char|字符串

文件中的标题线数,指定为逗号分隔对组成“NumHeaderLines”和一个正整数。如果未指定,导入功能自动检测的文件中的首标线的数量。

例子:'numheaderlines',7

数据类型:|

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

数据类型:|

从文本或电子表格文件读取数据,指定为逗号的部分分开一对组成的'范围'以及其中一种形式的字符向量、字符串标量或数字向量。

指定的方法范围 描述

从细胞

“细胞”(行坳)

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

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

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

使用起始细胞,进口功能自动开始导入在开始细胞,并在最后一个空行或注脚范围结束检测数据的范围。

例子:'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和终端列的四个元素数字向量的范围。例如,[2 3 15 13]

导入功能仅读取指定范围内包含的数据。指定范围内的任何空字段都将导入丢失的单元格。

行范围或列范围

'row1:row2'“列1:列2”

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

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

例子:'5:500'

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

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

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

例子:“答:K”

起始行号

N

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

使用指定的行索引,进口功能自动通过从指定的第一行读出到数据或页脚范围的结束检测数据的程度。

例子:5.

Excel的命名范围

“NamedRange”

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

例子:'范围','mytable'

未指定或空

''

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

例子:“范围”,“

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

数据类型:char|字符串|

输入导入的文本数据,指定为逗号分隔的配对组成“TextType”和任何一种'char'“字符串”

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

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

例子:“TextType”、“生物炭”

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

价值 键入导入的日期和时间数据
'约会时间'

MATLABdatetime数据类型

有关更多信息,请参阅datetime

“文本”

如果'dateTimetype'被指定为“文本”,然后输入日期和时间数据的类型取决于所指定的值“TextType”参数:

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

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

“exceldatenum”

Excel序列日期号码

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

数据类型:char|字符串

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

例子:“尾声”,{'na','tbd'}指示导入函数处理任何出现的NATBD.作为缺少的领域。

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

将第一行读为变量名称,指定为分隔的配对组成'readvariablenames'和任何一种真正的错误的.如果未指定,导入函数会自动检测变量名称的存在。

指标

描述

真正的

当使用区域来读取第一行包含表的变量名。进口函数创建一个变量,与检测到的变量的名称,在每个列T.

错误的

当要读取的区域的第一行包含表中的数据时。导入函数创建表单的默认变量名称'var1',......,'varn',在那里N是变量的数目。

未指明的 当未指定时,导入函数自动检测真正的错误的并相应收益。

当你指定ReadVariableNames名称-值对选择,则导入函数继续如下操作。

  • 如果ReadVariableNames被设定为真正的,那么进口功能通过读取指定的文件中的变量名variablenamesrange.或者VariableNamesLine导入选项对象的属性。

  • 如果ReadVariableNames被设定为错误的,然后导入函数从中读取变量名称variablenames.导入选项对象的属性。

数据类型:逻辑

行时间变量,指定为逗号分隔对'rowtimes'和变量名或一个时间矢量。

  • 变量名称必须是在包含输入表格包含任何变量的名称的字符向量或标量串datetime期间值。由变量名指定的变量为行提供行时间标签。输入表的其余变量成为时间表的变量。

  • 时间向量一定是adatetime矢量或A.期间向量。时间向量的元素数必须等于输入表的行数。时间向量中的时间值不需要是唯一的,排序或常规。输入表的所有变量都变为时间表的变量。

数据类型:char|字符串|datetime|期间

行时间的采样率,指定为逗号分隔的对组成“SampleRate”和一个正数标量。采样率是输出时间表的时间向量的每秒样本数(Hz)。

当你使用时“SampleRate”指定时间表的行时间矢量,默认第一行时间(开始时间)为零秒。要设置为零以外的开始时间,指定'开始时间'名称-值对。

数据类型:

行之间的时间步长,指定为逗号分隔的对,由'timestep'和持续时间标量或calendarDuration标量。价值'timestep'参数指定连续行之间的时间长度。导入函数使用时间步长值来计算定期间隔的行时间。

当你使用时'timestep'指定时间表的行时间矢量,默认第一行时间(开始时间)为零秒。要设置为零以外的开始时间,指定'开始时间'名称-值对。

如果是'timestep'是日历持续时间值,则'开始时间'必须是一个日期时间值。

数据类型:期间|calendarDuration

行时间的开始时间,指定为逗号分隔的对,由开始时间以及datetime标量或duration标量。

要定义时间表的时间向量,请使用'开始时间'用的“SampleRate”或者'timestep'名称-值对参数。

开始时间的数据类型指示行时间向量的数据类型。

  • 如果开始时间是DateTime值,则时间表的行次数为DateTime值。

  • 如果开始时间是一个持续时间值,那么行时间就是持续时间。

数据类型:datetime|期间

标志以保留变量名称,指定为逗号分隔的配对组成VariableNamingRule和任何一种'调整''保存'

  • '调整'- 转换无效的变量名称(如由确定isvarname功能),有效MATLAB标识符。

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

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

数据类型:char|字符串

只有文本文件

全部收缩

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

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

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

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

以白色空间对待的字符,指定为包含一个或多个字符的字符向量或字符串标量。

例子:'空白', '_'

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

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

例子:' LineEnding ', ' \ n '

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

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

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

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

例如,要在同一行上挂牌略有百分之符号,请指定CommentStyle作为'%'

例子:CommentStyle,{“/ *”}

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

与文件相关联的字符编码方案,指定为包含的逗号分隔对'编码'“系统”或标准字符编码方案名称。如果不指定任何编码,则readtimetable函数使用自动字符集检测来确定所述编码读取文件时。

如果指定'编码'参数除了导入选项,那么readtimetable函数使用的指定值'编码',覆盖在导入选项中定义的编码。

例子:“编码”,“utf - 8”使用UTF-8编码。

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

数据类型:char|字符串

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

价值 导入持续时间数据的类型
'期间'

MATLAB期间数据类型

有关更多信息,请参阅期间

“文本”

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

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

  • 如果“TextType”被设定为“字符串”,然后进口函数返回的持续时间数据作为一个字符串数组。

数据类型:char|字符串

读取日期的区域设置,指定为逗号分隔的对,由'datelocale'以及表单的字符矢量或字符串标量XX._YY, 在哪里:

  • YY是大写的ISO 3166-1 alpha-2代码,表示国家。

  • XX.是小写的ISO 639-1两字母代码,表示一种语言。

有关区域设置的公共值列表,请参见语言环境的名称-值对参数datetime功能。

使用时%d格式说明读取文本datetime值,使用DateLocale要指定区域设置,导入函数应在其中解释月、日、周的名称和缩写。

如果指定DateLocale除…之外选择的,然后导入函数使用指定的值DateLocale参数,覆盖导入选项中定义的语言环境。

例子:“DateLocale”、“ja_JP”

字符表示数值变量小数分隔,指定为字符向量或标量的字符串。进口函数使用指定字符DecimalSeparator名称 - 值对以将数字的整数部分与十进制部分区分开来。

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

例子:如果名称-值对指定为'decimalseparator',',',然后导入函数导入文本“3,14159”作为数字3.14159

数据类型:char|字符串

表示在数字变量中分组的数千个字符,指定为字符向量或字符串标量。数千个分组字符充当视觉分离器,在每三个位置计算数字。进口函数使用指定字符ThousandsSeparator名称值对以解释正在导入的数字。

例子:如果名称-值对指定为“ThousandsSeparator”、“,”,然后导入函数导入文本“1,234,000”作为1234000

数据类型:char|字符串

从一个数字变量除去非数字字符,指定为逻辑真正的错误的

例子:如果名称-值对指定为'TrimNonNumeric',真,那么导入函数读取'$ 500 / - '作为500.

数据类型:逻辑

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

连续分隔符规则 行为
“分裂” 拆分连续分隔成多个领域。
'加入' 将分隔符连接为一个分隔符。
'错误' 返回一个错误并中止导入操作。

数据类型:char|字符串

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

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

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

领先的分隔符规则 行为
“保持” 分隔符。
“忽略” 忽略分隔符。
'错误' 返回一个错误并中止导入操作。
电子表格文件只

全部收缩

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

规范 行为
''(默认) 从第一个工作表导入数据。
的名字 无论电子表格文件中的纸张订单如何导入匹配的工作表名称。
整数 无论电子表格文件中的工作表名称如何,在由整数表示的位置从工作表导入数据。

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

标志开始的一个实例Microsoft Excel对于Windows,当读取电子表格数据时,指定为逗号分隔对,由'UseExcel'和任何一种真正的,或错误的

你可以设置'UseExcel'参数设置为以下值之一:

  • 真正的—导入功能在读取文件时启动Microsoft Excel实例。

  • 错误的—导入功能在读取文件时不会启动Microsoft Excel实例。在此模式下操作时,导入函数功能的不同在于支持文件格式和交互特性,如公式和宏。万博1manbetx

meftexcel.

真正的

错误的

万博1manbetx支持的文件格式

.xls、.xlsx、.xlsm、.xltx、.xltm、.xlsb、.ods

.xls,.xlsx,.xlsm,.xltx,.xltm

万博1manbetx支持交互式功能,例如公式和宏

是的

没有

从Windows平台上的电子表格文件读取时,如果要启动一个实例Microsoft Excel,然后设置'UseExcel'参数真正的

仅限XML文件

全部收缩

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

例子:'AttributeSuffix', '_ ATT'

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

例子:'ImportAttributes',假

表行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',{ '/根节点/ ChildNode'}

例子:'VariableElectors',“/ rootnode / shardnode”

例子:'VariableSelectors',[ “/根节点/ ChildNode1”, “/根节点/ ChildNode2”]

表XML节点名称,指定为逗号分隔对'tablenodename'或者是字符向量或者是字符串标量。此参数指定了读取函数应该读取到表中的输入结构中的节点。

例子:'tablenodename','nodename'

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

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

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

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

变量描述的XPath表达式,指定为字符向量或标量的字符串,该读取功能读取的用途来选择表变量的描述。您必须指定VariableDescriptionsSelector作为有效的XPath 1.0版本表达式。

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

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

重复节点规则

行为

“addcol”

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

“忽略”

跳过导入重复的节点。

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

例子:“RepeatedNodeRule”、“忽略”

设定注册的XML命名空间前缀的,指定为逗号分隔的一对组成的RegisteredNamespaces和前缀数组。读取函数在对XML文件求XPath表达式时使用这些前缀。将名称空间前缀及其关联的url指定为Nx2字符串数组。RegisteredNamespaces时,可以使用还评估由选择的名称 - 值参数指定的XPath表达式,如structSelector.为了阅读,或VariableSelectors为了readtablereadtimetable

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

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

T = readtable( “的example.xml”, “VariableSelector”, “/ myprefix:数据”,... “RegisteredNamespaces”,[“myprefix”,“//www.tianjin-qmedu.com”])

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

输出参数

全部收缩

输出时间表。时间表可存储元数据,例如描述,可变单元,变量名,和行次。欲了解更多信息,请参阅的属性部分时间表

提示

  • XPath选择器名称值参数支持以下XPath语法,例如万博1manbetxRowSelectorVariableSelector

    • 要选择他的名字要选择,无论其在文档中的位置的节点相匹配的所有节点上,使用" / / myNode”句法。您可以使用" / / myNode”省略要选择的节点之前的XPath表达式。

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

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

在R2019A介绍