主要内容

ReadTimetable.

从文件创建时间表

描述

例子

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

ReadTimetable.根据文件扩展名确定文件格式:

  • .txt.dat.csv.用于分隔的文本文件

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

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

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

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

例子

TT.=重新阅读时间表(文件名选择另外使用导入选项选择

例子

TT.=重新阅读时间表(___名称,价值使用一个或多个名称-值对参数指定的附加选项从文件创建时间表。在指定名称-值对之前,请使用前面语法中的任何输入参数。

要为数据设置特定的导入选项,您可以使用选择对象,也可以指定名称-值对。当您指定名称-值对时选择那么ReadTimetable.万博1manbetx仅支持以下名称-值对:

  • 文本和电子表格参数-ReadVariableNames划船次数采样率时间步长开始时间

  • 纯文本参数-DateLocale编码

  • 仅电子表格参数-使用Excel

例子

全部崩溃

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

TT = readtimetable ('outages.csv');

显示表的摘要。创建时间表时,如果未为行时间指定任何参数,则ReadTimetable.函数检测和指定数据中的第一个DATETIME或持续时间变量,OutageTime,作为行时间变量。剩下的变量将成为时间表的变量。

总结(TT)
行时:中断时间:1468x1日期时间值:最小值2002-02-01 12:18中值2010-03-18 21:05最大值2014-01-15 02:41变量:区域:1468x1字符向量单元格数组丢失:1468x1双值:最小值0中值180.26最大值23418 Numming 604客户:1468x1双值:最小值0中值75765最大值5.9689e+06 Numming 328恢复时间:1468x1日期时间值:最小值2002-02-07 16:50中位数2010-03-31 10:54最大值2042-09-18 23:31数字运算原因:1468x1字符向量单元格数组

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

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

选择= detectImportOptions ('outages.csv'); opts.VariableOptions
ans=1x6异构VariableImportOptions(TextVariableImportOptions、DatetimeVariableImportOptions、NumericVariableImportOptions)数组,具有以下属性:名称类型FillValue处理缺少引号前缀后缀EmptyFieldRule

修改options对象以为数据中的变量指定所需的数据类型。更改变量的数据类型地区导致直截了当的。

opts = setvartype(opts,{'地区'“因为”},{'分类''分类'});

使用ReadTimetable.以及选项对象以导入时间表。然后显示时间表的摘要。

TT = readtimetable ('outages.csv',选择);总结(TT)
RowTimes: OutageTime: 1468x1 datetime Values: Min 2002-02-01 12:18中位数2010-03-18 21:05 Max 2014-01-15 02:41 Variables: Region: 1468x1 categoryvalues: MidWest 142 NorthEast 557 SouthEast 389 SouthWest 26 West 354 Loss: 1468x1 double Values: Min 0中位数180.26 Max 23418 NumMissing 604 Customers: 1468x1 double Values:最小0值75765最大5.9689 e + 328年06 NumMissing RestorationTime: x1 datetime值:1468分钟2002-02-07 16:50值2002-02-07 10:54 Max 2002-02-07二三31 NumMissing 29原因:1468 x1分类值:攻击294地震188能源应急设备故障156火25 95年201年338年暴风雷雨未知24日风145年冬季风暴

从逗号分隔的文本文件中读取一个表,并创建一个带有您选择的行乘以变量的时间表。

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

选择= detectImportOptions ('outages.csv');预览('outages.csv',选项)
ans =.8×6表该地区的时间损失时间损失时间损失客户的时间损失客户恢复时间造成时间损失时间损失客户恢复时间损失客户恢复时间引起引起地区地区地区的时间损失时间损失时间损失客户恢复时间造成时间造成时间损失时间损失客户的时间损失客户恢复时间造成造成时间原因,时间损失时间损失时间损失客户恢复时间造成时间原因,时间损失时间损失客户恢复时间造成造成造成造成时间原因,时间原因(UUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUUU这句话的意思是:“冬天的风暴,东南部的”,意思是“冬天的风暴”,意思是“东南部的”2003-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:18186.44 2.1275e+052002-03-18 23:23{'Severy storm'}{'2003-06-18 02:49 00 2003-06-06-18 10:54{'attack West'}2004-06-20-14:39 231 NaN-20'West'{'equipment fault'}2002-06-06 19:28311.86南2002-06-07 00:51{‘设备故障}

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

TT = readtimetable ('outages.csv'“划船时间”“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

从电子表格文件创建时间表并格式化输入数据。例如,从文件创建时间表1999年至2019年第四季度财务报表,指定时间戳的开始日期以及它们之间的每个时间,并从数据中删除“$”符号。

读取文件中的数据1999年至2019年第四季度财务报表作为时间表。在1999年1月1日开始的日期开始指定连续行时间之间的时间长度为一个日历季度。'preservevariablenames'真的要保留变量名称中的空白,请执行以下操作:“非数字”真的删除数据中数值前的“$”符号。

TT = readtimetable (“quarterlyFinances1999To2019.csv”“时间步”calquarters (1)“开始时间”,日期时间(1999年1月1日),......“保存变量名称”是的,“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'

互联网网址

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

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

远程位置

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

方案名称: / /path_to_file/my_file.ext.

基于远程位置,方案名称可以是该表中的值之一。

远程位置 方案名称
Amazon S3™ s3
WindowsAzure®水滴存储 黄金黄蜂
HDFS™ HDFS.

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

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

  • 如果文件名包含文件扩展名,然后导入函数根据扩展名确定文件格式。否则,必须指定“文件类型”用于指示文件类型的名称-值对参数。

  • 在窗户上®与微软的系统®擅长®软件中,导入功能可读取您的Excel版本识别的任何Excel电子表格文件格式。

  • 如果您的系统没有Windows的Excel,或者您正在使用Matlab Online™时,导入函数使用使用Excel属性设置为假的,只读.xls、.xlsx、.xlsm、.xltx和.xltm文件。

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

数据类型:烧焦|细绳

文件导入选项,指定为一个SpreadsheetImportOptionsdelimitedtextimportoptions.固定宽度导入XMLImportOptions对象创建的侦探函数。的选择对象包含控制数据导入过程的属性。有关每个对象属性的更多信息,请参阅相应的对象页面。

文件类型 输出
电子表格文件 SpreadsheetImportOptions对象(仅适用于数据范围,及变化无常属性)
文本文件 delimitedtextimportoptions.目的
固定宽度文本文件 固定宽度导入目的
XML文件 XMLImportOptions目的

名称-值对的观点

指定可选的逗号分离对名称,价值参数。名称是参数名和价值是对应的值。名称必须出现在引号内。您可以按任意顺序指定多个名称和值对参数,如下所示:Name1, Value1,…,的家

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

全部崩溃

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

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

  • .txt.dat.csv.用于分隔的文本文件

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

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

数据类型:烧焦|细绳

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

例子:'numheaderlines',7

数据类型:单一的|双倍的

预期的变量数,指定为逗号分隔对组成'预期的内瓦里亚布尔'一个正整数。如果未指定,导入函数将自动检测变量的数量。

数据类型:单一的|双倍的

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

指定的方式范围 描述

起始电池

“细胞”(行坳)

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

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

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

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

例子:“A5”[5 1]

矩形范围

“Corner1: Corner2”[r1 c1 r2 c2]

在其中一个表单中使用矩形范围指定要读取的精确范围。

  • “Corner1: Corner2”- 使用范围角落1角落2哪两个相对的角定义了要在Excel中读取的区域A1符号例如“C2: N15”

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

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

行范围或列范围

'row1:row2'“Column1:Column2”

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

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

例子:'5:500'

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

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

指定范围内的列数必须与预期数变量财产。

例子:“答:K”

起始行号

N

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

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

例子:5.

Excel的命名范围

“NamedRange”

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

例子:“范围”、“myTable”

不明或空

''

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

例子:'范围',''

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

数据类型:烧焦|细绳|双倍的

输入文本数据的类型,指定为逗号分隔对,由'texttype',要么“字符”'细绳'

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

  • '细绳'-将文本数据导入MATLAB作为字符串数组。

例子:'texttype','char'

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

价值 导入的日期和时间数据的类型
“日期时间”

马铃薯datetime数据类型

有关详细信息,请参阅datetime

“文本”

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

  • 如果'texttype'被设置为“字符”,则导入函数以字符向量单元格数组的形式返回日期。

  • 如果'texttype'被设置为'细绳',然后导入函数将日期作为字符串数组返回。

“exceldatenum”

Excel序列日期编号

序列日期编号是一个数字,等于从给定参考日期算起的天数。Excel序列日期编号使用与MATLAB序列日期编号不同的参考日期。有关Excel日期的详细信息,请参见https://万博1manbetxsupport.microsoft.com/en-us/kb/214330

数据类型:烧焦|细绳

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

例子:“尾声”,{'na','tbd'}指示导入函数处理任何出现的NA待定作为缺失的字段。

数据类型:烧焦|细绳|细胞

将第一行作为变量名读取,指定为逗号分隔对,由“ReadVariableNames”,要么真的假的.如果未指定,导入函数将自动检测变量名的存在。

指标

描述

真的

当要读取的区域的第一行包含表的变量名时使用。导入函数为中的每一列创建一个变量,其中包含检测到的变量名T.

假的

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

未指明的 未指定时,导入功能会自动检测真的假的并相应地进行。

当您指定时ReadVariableNames名称-值对选择,然后导入函数按如下步骤进行。

  • 如果ReadVariableNames被设置为真的,然后导入函数使用variablenamesrange.或者变化无常线导入选项对象的属性。

  • 如果ReadVariableNames被设置为假的,然后导入函数从变化无常导入选项对象的属性。

数据类型:逻辑

行时间变量,指定为逗号分隔对,由“划船时间”和变量名或时间向量。

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

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

数据类型:烧焦|细绳|datetime|期间

行时间的采样率,指定为逗号分隔对,由'采样率'和一个正数值标量。采样率是输出时间表时间向量的每秒采样数(Hz)。

当你使用'采样率'要指定时间表的行时间向量,默认的第一行时间(开始时间)为零秒。要设置非零的开始时间,请指定'开始时间'名称值对。

数据类型:双倍的

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

当你使用“时间步”要指定时间表的行时间向量,默认的第一行时间(开始时间)为零秒。要设置非零的开始时间,请指定'开始时间'名称值对。

如果“时间步”是日历持续时间值,然后是'开始时间'必须是日期时间值。

数据类型:期间|日历

行时间的开始时间,指定为逗号分隔的对组成开始时间和日期时间标量或持续时间标量。

要定义时间表的时间向量,请使用'开始时间'有两个'采样率'或者“时间步”名称-值对参数。

开始时间的数据类型,决定了行时间向量的数据类型。

  • 如果开始时间为datetime值,则时间表的行时间为datetime值。

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

数据类型:datetime|期间

保留变量名的标志,指定为逗号分隔对,由变化多端,要么'调整'“保存”

  • '调整'-转换无效的变量名(由伊斯瓦名称函数)的有效MATLAB标识符。

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

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

数据类型:烧焦|细绳

文本文件只

全部崩溃

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

例子:'delimiter','|'

例子:'delimiter',{';','*'}

数据类型:烧焦|细绳|细胞

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

例子:“空白”、“_”

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

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

例子:“LineEnding”,“\n”

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

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

数据类型:烧焦|细绳|细胞

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

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

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

数据类型:烧焦|细绳|细胞

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

如果指定'编码'参数,然后ReadTimetable.函数将指定的值用于'编码',覆盖在导入选项中定义的编码。

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

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

数据类型:烧焦|细绳

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

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

马铃薯期间数据类型

有关详细信息,请参阅期间

“文本”

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

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

  • 如果'texttype'被设置为'细绳',然后导入函数以字符串数组的形式返回持续时间数据。

数据类型:烧焦|细绳

用于阅读日期的区域设置,指定为逗号分隔的配对“DateLocale”以及这种形式的字符向量或字符串标量xx_yy.,地点:

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

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

有关区域设置的公共值列表,请参见场所的名称-值对参数datetime函数。

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

如果指定DateLocale除…之外选择导入选项,然后导入函数使用指定的DateLocale参数,覆盖在导入选项中定义的区域设置。

例子:“DateLocale”,“ja_JP”

在数字变量中指示十进制分隔符的字符,指定为字符向量或字符串标量。属性中指定的字符DecimalSeparator名称-值对,用于区分数字的整数部分和小数部分。

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

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

数据类型:烧焦|细绳

在数字变量中指示数以千计分组的字符,指定为字符向量或字符串标量。数以千计的分组字符充当了视觉分隔符,每三个位置的值分组一个数字。属性中指定的字符数千律师名称值对以解释正在导入的数字。

例子:如果将名称-值对指定为'数千律师',',',然后导入函数导入文本"1,234,000"作为1234000.

数据类型:烧焦|细绳

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

例子:如果将名称-值对指定为“TrimNonNumeric”,true,则导入函数读取'$500/-'作为500

数据类型:逻辑

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

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

数据类型:烧焦|细绳

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

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

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

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

全部崩溃

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

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

数据类型:烧焦|细绳|单一的|双倍的

要启动的实例的标志微软Excel读取电子表格数据时的Windows,指定为包括的逗号分隔对“UseExcel”,要么真的假的

您可以设置“UseExcel”参数设置为以下值之一:

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

  • 假的- 读取文件时,导入功能不会启动Microsoft Excel的实例。在此模式下运行时,导入功能功能在文件格式和交互功能的支持下不同,例如公式和宏。万博1manbetx

使用Excel

真的

假的

万博1manbetx支持文件格式

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

.xls、.xlsx、.xlsm、.xltx、.xltm

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

是的

没有

在Windows平台上读取电子表格文件时,如果要启动微软Excel,然后设置“UseExcel”参数真的

仅限XML文件

全部崩溃

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

例子:“AttributeSuffix”,“附件”

导入属性,指定为逗号分隔对组成“ImportAttributes”,要么1真的) 或者0.假的).如果您指定假的,则reading函数不会将输入文件中的XML属性作为变量导入输出表。

例子:“ImportAttributes”,假的

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

例子:“RowNodeName”、“XMLNodeName”

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

例子:'rowselector','/ rootnode / shordnode'

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

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

例子:'variablenodenames',“xmlnodename”

例子:'variablenodenames',[“xmlnodename1”,“xmlnodename2”]

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

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

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

例子:'VariableSelectors',[“/RootNode/ChildNode1”,“/RootNode/ChildNode2”]

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

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

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

例子:'tableselector','/ rootnode / shordnode'

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

例子:'VariableUnitsSelector','/RootNode/ChildNode'

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

例子:“VariableDescriptionSelector',”/RootNode/ChildNode'

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

重复节点规则

行为

“addcol”

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

“忽略”

跳过导入重复的节点。

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

例子:'repedednoderule','忽略'

已注册的XML名称空间前缀集,指定为逗号分隔对,由注册名称空间和前缀数组。读取函数在对XML文件求XPath表达式时使用这些前缀。将名称空间前缀及其关联的url指定为Nx2字符串数组。注册名称空间也可以在计算选择器名称-值参数指定的XPath表达式时使用,例如structSelector.对于readstruct可变选择器对于readtableReadTimetable.

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

例如,在名为example.xml不包含命名空间前缀。指定'注册NameSpaces'作为[" myprefix ", " //www.tianjin-qmedu.com ")分配前缀我的前缀到网址//www.tianjin-qmedu.com

T=readtable(“example.xml”、“VariableSelector”、“/myprefix:Data”、…”RegisteredNamespaces“,[“myprefix”,”//www.tianjin-qmedu.com”])

例子:“注册namespaces”,[“myprefix”,“//www.tianjin-qmedu.com”]

输出参数

全部崩溃

输出的时间表。时间表可以存储描述、变量单位、变量名和行时间等元数据。有关更多信息,请参见属性部分时间表

提示

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

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

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

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

在R2019A介绍