主要内容

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仅支持这些名称值对:

  • 文本和电子表格参数 -readvariablenames.rowtimes.采样率时间戳开始时间

  • 文本只参数 -DateLocale编码

  • 仅电子表格参数-meftexcel.

例子

全部收缩

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

TT = readtimetable ('outages.csv');

显示表的摘要。创建时间表时,如果您未指定行时间的任何参数,那么ReadTimetable.函数检测和指定数据中的第一个DATETIME或持续时间变量,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');opts.variableOptions.
ans = 1x6异构可变导入选项(TextVarifeimportOptions,DateTimeVareifeImportOptions,NumericVareaseImportOptions)数组与属性:名称类型FirpValue injamissing QuoteRule Prefixes Seftixes extentFieldRule

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

opts = setvartype(opts,{'地区''原因'},{'分类''分类'});

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

TT = readtimetable ('outages.csv',选择);总结(TT)
Rowtimes:OutageTime:1468x1 DateTime值:Min 2002-02-01 12:18中位数2010-03-18 21:05 Max 2014-01-15 02:41变量:区域:1468x1分类价值:1468x1分类价值:中西部142东北557东南389西南38926 West 354损失: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:54 Max 2042-09-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损失客户恢复时间___________________________________________________________________________________________________________________________________________________________________02-07 16:50 {'冬季风暴'} {'southeast'} 2003-01-23 00:49 530.14 2.1204E + 05 Nat {'冬季风暴'} {'Southeast'} 2003-02-07 21:15 289.4 1.4294E + 05 2003-02-17 08:14 {冬季风暴'} {'west'} 2004-04-06 05:44 434.81 3.4037E + 05 2004-04-06 06:10 {'midwest'} {'midwest'} 2002-03-16 06:18 186.44 2.1275E +05 2002-03-18 23:23 {'secort Storm'} {'West'} 2003-06-18 02:49 0 0 2003-06-18 10:54 {'攻击'} {'West'} 2004-06-20 14:39 231.29 NaN 2004-06-20 19:16 {'equipment fault'} {'West' } 2002-06-06 19:28 311.86 NaN 2002-06-07 00:51 {'equipment fault'}

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

TT = readtimetable ('outages.csv''rowtimes'“RestorationTime”);总结(TT)
RowTimes: RestorationTime: 1468x1 datetime Values: Min 2002-02-07 16:50中位数2010-03-31 10:54 Max 2042-09-18 23:31 NumMissing 29 Variables: Region: 1468x1 cell array of character vectors OutageTime: 1468x1 datetime Values: Min 2002-02-01 12:18中位数2010-03-18 21:05 Max 2014-01-15 02:41 Loss: 1468x1 double Values:Min 0中位数180.26 Max 23418 NumMissing 604 Customers: 1468x1 double Values: Min 0中位数75765 Max 5.9689e+06 NumMissing 328 Cause: 1468x1 cell array of character vectors

从电子表格文件创建时间表并格式化输入数据。例如,从文件中创建时间表季度融资1999to2019.csv.,指定时间戳的开始日期以及它们之间的每个时间,并从数据中删除“$”符号。

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

TT = readtimetable (“quarterlyFinances1999To2019.csv”“timestep”,Calquarters(1),“开始时间”,DateTime(1999,1,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”

互联网网址

如果文件指定为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 Storage. 黄金草原
HDFS™ HDFS.

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

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

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

  • 在Windows上®与微软系统®excel.®软件,导入功能读取您版本的Excel识别的任何Excel电子表格文件格式。

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

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

数据类型:char|细绳

文件导入选项,指定为SpreadSheetimportOptions.delimitedtextimportoptions.多个沃特莫特选项, 或者xmlimportoptions.由此创建的对象侦探函数。这选择对象包含控制数据导入过程的属性。有关每个对象属性的更多信息,请参阅相应的对象页面。

文件类型 输出
电子表格文件 SpreadSheetimportOptions.对象(仅对数据范围, 和variablenames.属性)
文本文件 delimitedtextimportoptions.对象
宽度固定的文本文件 多个沃特莫特选项对象
XML文件 xmlimportoptions.对象

名称-值对的观点

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

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

全部收缩

文件类型,指定为逗号分隔对,由'文件类型'“文本”或者'电子表格'

指定'文件类型'名称 - 值对参数何时文档名称不包括文件扩展名,或者扩展名不是下列之一:

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

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

例子:'filetype','text'

数据类型:char|细绳

文件中的标题线数,指定为逗号分隔对组成'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]- 使用包含Start-Row,Start-Column,End-Row和终端列的四个元素数字向量的范围。例如,[2 3 15 13]

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

行范围或列范围

“第一行:Row2”或者'第1列:column2'

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

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

例子:“5:500”

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

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

指定范围中的列数必须与指定的数字匹配预示.财产。

例子:“答:K”

起始行号

n

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

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

例子:5

Excel的命名范围

'namedrange'

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

例子:'范围','mytable'

未指定或空的

''

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

例子:'范围',''

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

数据类型:char|细绳|双倍的

输入导入的文本数据,指定为逗号分隔的配对组成'texttype'和任何一种'char'或者'细绳'

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

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

例子:'texttype','char'

类型用于导入的日期和时间数据,指定为由“DatetimeType”和其中一个值:'约会时间'“文本”, 或者“exceldatenum”.价值“exceldatenum”只适用于电子表格文件,而不适用于文本文件。

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

马铃薯datetime数据类型

有关更多信息,请参阅datetime

“文本”

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

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

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

“exceldatenum”

Excel序列日期号码

序列日序是单个数字等于给定参考日期的天数。Excel序列日序号使用与Matlab序列日期号不同的其他参考日期。有关Excel日期的更多信息,请参阅https://万博1manbetxsupport.microsoft.com/en-us/kb/214330

数据类型:char|细绳

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

例子:TreatAsMissing,{“NA”,“TBD”}指示导入函数处理任何出现的NA或者TBD.作为缺少的领域。

数据类型:char|细绳|细胞

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

指示器

描述

真的

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

错误的

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

未指明的 左侧未指定后,导入功能会自动检测真的或者错误的并相应地进行。

当您指定时readvariablenames.名称-值对选择,然后导入函数进行如下所示。

  • 如果readvariablenames.被设定为真的,然后使用的导入函数通过使用指定文件从指定文件中读取变量名称VariableNamesRange或者variablenamesline.导入选项对象的属性。

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

数据类型:逻辑

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

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

  • 时间向量一定是adatetime向量或一个期间向量。时间向量的元素数必须等于输入表的行数。时间向量中的时间值不需要是唯一的、有序的或常规的。输入表中的所有变量都变成了时间表的变量。

数据类型:char|细绳|datetime|期间

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

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

数据类型:双倍的

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

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

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

数据类型:期间|日历

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

要定义时间表的时间向量,请使用“开始时间”与之无论'采样率'或者'timestep'名称-值对参数。

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

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

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

数据类型:datetime|期间

标志以保留变量名称,指定为逗号分隔的配对组成variablenamingrule.和任何一种“修改”或者'保存'

  • “修改”- 转换无效的变量名称(由此确定)isvarname.功能)到有效的MATLAB标识符。

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

从R2019b开始,变量名和行名可以包含任何字符,包括空格和非ascii字符。此外,它们可以以任何字符开头,而不仅仅是字母。变量和行名不一定是有效的MATLAB标识符(由isvarname.功能)。要保留这些变量名和行名,可以设置variablenamingrule.'保存'

数据类型:char|细绳

仅文本文件

全部收缩

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

例子:'delimiter','|'

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

数据类型:char|细绳|细胞

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

例子:'空白','_'

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

线端字符,指定为字符向量,字符串标量,字符向量的单元格数组或字符串数​​组。

例子:'排队','\ n'

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

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

数据类型:char|细绳|细胞

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

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

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

数据类型:char|细绳|细胞

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

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

例子:'编码','utf-8'使用UTF-8作为编码。

例子:'编码','system'使用系统默认编码。

数据类型:char|细绳

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

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

马铃薯期间数据类型

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

“文本”

如果'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|细绳

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

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

数据类型:char|细绳

从数字变量中删除非数字字符,指定为逻辑真的或者错误的

例子:如果将名称值对指定为'trimnonnumeric',true,然后导入功能读取'500美元/ - '作为500.

数据类型:逻辑

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

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

数据类型:char|细绳

管理定界文本文件中的前导定界符(指定为本表中的值之一)的过程。

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

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

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

全部收缩

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

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

数据类型:char|细绳|单身的|双倍的

旗帜开始一个实例微软Excel.读取电子表格数据时的Windows,指定为包括的逗号分隔对'使用'和任何一种真的, 或者错误的

你可以设置'使用'参数到其中一个值:

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

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

meftexcel.

真的

错误的

万博1manbetx支持的文件格式

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

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

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

是的

没有

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

XML文件只

全部收缩

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

例子:'attributesuffix','_ att'

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

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

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

例子:'rownodename','xmlnodename'

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

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

表变量XML节点名称,指定为逗号分隔对组成'variablenodenames'以及字符向量或字符串阵列的单元格数组。此参数指定读取函数用于识别XML节点以读取为输出表中的变量的XML节点名称。

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

例子:“VariableNodeNames”、“XMLNodeName”

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

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

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

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

例子:'VariaBliceElectors',[“/ rootnode / shildnode1”,“/ rootnode / shildnode2”]

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

例子:'tablenodename','nodename'

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

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

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

例子:'“变量单独选择”,“/ rootnode / shildnode”

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

例子:'variabledescriptions selector','/ rootnode / shildnode'

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

重复节点规则

行为

“addcol”

在表格中的变量标题下添加列的列。指定值'重复诺德鲁莱恩'作为“addcol”不会在表中为重复节点创建单独的变量。

“忽略”

跳过导入重复节点。

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

例子:'repedednoderule','忽略'

一组注册的XML命名空间前缀,指定为逗号分隔对组成注册NameSpaces.和前缀数组。读取函数在对XML文件求XPath表达式时使用这些前缀。将名称空间前缀及其关联的url指定为Nx2字符串数组。注册NameSpaces.当您还要评估选择器名称值参数指定的XPath表达式时,可以使用,例如StructSelector为了阅读, 或者变形electors.为了readtableReadTimetable.

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

例如,评估名为XML文件的XPath表达式example.xml不包含命名空间前缀。指定'注册NameSpaces'作为[“MyPrefix”,“//www.tianjin-qmedu.com”]分配前缀MyPrefix.到网址//www.tianjin-qmedu.com.

t = readtable(“example.xml”,“VariableelElector”,“/ MyPrefix:Data”,...“注册NameSpace”,[“MyPrefix”,“//www.tianjin-qmedu.com”))

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

输出参数

全部收缩

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

提示

  • XPath选择器名称-值参数支持以下XPath语法,例如万博1manbetxRowselector.或者variablingelector

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

    • 要在文件中的一个父节点下读取几个兄弟节点之一,可以指定儿童编码[n, 在哪里n对应于要索引的兄弟节点。例如,路径“/ rootnode / shordnode [2]”选择第二个ChildNode元素的父元素是扎根

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

介绍了R2019a