tabularTextDatastore

包含在数据存储中的文件，解析为字符向量元胞数组或字符串数组，其中每个字符向量或字符串表示文件的一个完整路径。tabularTextDatastore 和 datastore 函数中的 location 参量定义这些文件。

Files 属性指定的第一个文件确定数据存储中的所有文件的变量名称和格式信息。

当您更改此属性的值时，数据存储函数会重新计算 TabularTextDatastore 属性的值。

示例: {"C:\dir\data\mydata1.csv";"C:\dir\data\mydata2.csv"}

文件编码，指定为类似于下列值之一的字符向量或字符串标量。

如果数据存储中的每个文件都能放入内存，则 FileEncoding 也可以是下列值之一。

当您更改此属性的值时，数据存储函数会重新计算 TabularTextDatastore 属性的值。

读取变量名称，指定为逻辑值 true 或 false。

当您更改此属性的值时，数据存储函数会重新计算 TabularTextDatastore 属性的值。

保留变量名称的标志，指定为 "modify" 或 "preserve"。

从 R2019b 开始，变量名称和行名称可以包含任何字符，包括空格和非 ASCII 字符。此外，它们可以由任何字符（而不仅仅是字母）开头。变量名称和行名称可以不是有效的 MATLAB 标识符（由 isvarname 函数决定）。要保留这些变量名称和行名称，请将 VariableNamingRule 的值设置为 "preserve"。当 VariableNamingRule 的值从 "modify" 更改为 "preserve" 时，变量名称不会刷新。

数据存储中的变量名称，指定为字符向量元胞数组或字符串数组。按变量显示在文件中的顺序指定变量名称。如果不指定变量名称，则从数据存储中的第一个文件的第一个非标头行中检测该名称。修改 VariableNames 属性时，新变量名称的数量必须与原始变量名称的数量匹配。

要支持无效的 MATLAB 标识符作为变量名称，例如包含空白和非 ASCII 字符的变量名称，请将 VariableNamingRule 参数的值设置为 "preserve"。

如果 ReadVariableNames 为 false，则 VariableNames 默认为 {"Var1","Var2", ...}。

示例: {"Time","Name","Quantity"}

文件开头要跳过的行数，指定为非负整数。如果未指定，tabularTextDatastore 函数将自动检测要跳过的行数。

读取变量名称或数据之前，tabularTextDatastore 函数会忽略指定数量的标题行。

当您更改此属性的值时，数据存储函数会重新计算 TabularTextDatastore 属性的值。

字段分隔符，指定为字符向量、字符向量元胞数组、字符串标量或字符串数组。可在一个字符向量元胞数组或字符串数组中指定多个分隔符。如果未指定，tabularTextDatastore 函数将自动检测分隔符。

示例: "|"

示例: {";","*"}

文件中重复的分隔符被解释为相互之间包含空字段的多个分隔符。如果未指定，默认情况下 read 函数将自动检测分隔符。

当您将以下转义序列之一指定为分隔符时，该序列将转换成对应的控制字符。

当您更改此属性的值时，数据存储函数会重新计算 TabularTextDatastore 属性的值。

行分隔符，指定为字符向量或字符串标量，必须为单个字符或者为 "\r"、"\n" 或 "\r\n" 之一。

当您更改此属性的值时，数据存储函数会重新计算 TabularTextDatastore 属性的值。

示例: ":"

视为缺失值的文本，指定为单个字符向量、字符向量元胞数组、字符串标量或字符串数组。指定为 TreatAsMissing 的值会替换为 MissingValue 属性中定义的值。例如，如果 MissingValue 定义为 NaN，并且 TreatAsMissing 指定为 "NA"。那么在导入的数据中，出现的所有 "NA" 都将替换为 NaN。

此选项仅适用于数值字段。此外，此属性等效于 textscan 函数的 TreatAsEmpty 名称-值对组参量。

当您更改此属性的值时，数据存储函数会重新计算 TabularTextDatastore 属性的值。

示例: "NA"

示例: {"-",""}

带分隔符的文本文件中缺失的数值字段的值，指定为标量。该属性等效于 textscan 函数的 EmptyValue 名称-值对组参量。

数据字段格式，指定为字符向量元胞数组或字符串数组，其中每个字符向量或字符串包含一个转换设定符。

当您指定或修改 TextscanFormats 属性时，可以使用 textscan 函数对 formatSpec 参量接受的相同转换设定符。TextscanFormats 的有效值包括跳过使用星号 (*) 字符的字段的转换设定符和跳过字面文本的转换设定符。转换设定符的数量必须与 VariableNames 属性中的变量数量匹配。

示例: {"%s","%s","%f"}

指数字符，指定为字符向量或字符串标量。默认的指数字符为 e、E、d 和 D。

用于区分文件中注释的注释字符，指定为字符向量、字符串标量或二元素字符串或元胞数组。

从 TabularTextDatastore 读取时，read 函数仅检查位于每个字段开头而不是字段中的注释。

当您更改此属性的值时，datastore 函数会重新计算 TabularTextDatastore 属性的值。

示例: "CommentStyle",{"/*", "*/"}

空白字符，指定为由一个或多个字符组成的字符向量或字符串标量。

当您将以下转义序列之一指定为空白字符时，datastore 会将该序列转换成对应的控制字符。

当您更改此属性的值时，数据存储函数会重新计算 TabularTextDatastore 属性的值。

示例: " \b\t"

多分隔符处理，指定为 true 或 false。如果是 true，则 datastore 将连续分隔符当作一个分隔符处理。由空白分隔的重复分隔符也被当作一个分隔符处理。

当您更改此属性的值时，数据存储函数会重新计算 TabularTextDatastore 属性的值。

要从文件中读取的变量，指定为字符向量元胞数组或字符串数组，其中每个字符向量或字符串包含一个变量的名称。可按任何顺序指定变量名称。

要支持无效的 MATLAB 标识符作为变量名称，例如包含空白和非 ASCII 字符的变量名称，请将 VariableNamingRule 参数的值设置为 "preserve"。

示例: ["Var3","Var7","Var4"]

要读取的选定变量的格式，指定为字符向量元胞数组或字符串数组，其中每个字符向量或字符串包含一个转换设定符。要读取的变量由 SelectedVariableNames 属性指示。SelectedFormats 中的字符向量或字符串数必须与要读取的变量数一致。

您可以使用 textscan 函数接受的相同转换设定符，包括跳过字面文本的设定符。但是，您不能使用跳过字段的转换设定符。也即，转换设定符不能包含星号字符 (*)。

示例: ["%d","%d"]

在调用 read 函数时要读取的数据量，指定为正标量或 "file"。

当您将 ReadSize 从数值标量更改为 "file" 时（反之亦然），MATLAB 会将数据存储重置为尚未从其中读取任何数据的状态。

文本变量的输出数据类型，指定为 "char" 或 "string"。TextType 指定使用 %s、%q 或 [...] 格式化的文本变量的数据类型。

行时间变量的名称，以名称-值参量形式指定，其中包含 "RowTimes" 和变量名称（如 "Date"）或变量索引（如 3）。

RowTimes 是与时间表相关的参数。时间表的每行都与一个时间相关联，该时间是在时间表的时间向量中捕获的。RowTimes 中指定的变量必须包含 datetime 或 duration 向量。

如果 "OutputType" 的值是 "timetable"，但您没有指定 "RowTimes"，则 TabularTextDatastore 使用第一个 datetime 或 duration 变量作为时间表的行时间。

用于构造数据存储的文件夹，以字符向量元胞数组形式返回。该元胞数组定向为一个列向量。每个字符向量均为指向一个包含数据文件的文件夹的路径。创建数据存储时，tabularTextDatastore 和 datastore 函数中的 location 参量用来定义 Folders。

当您修改 TabularTextDatastore 对象的 Files 属性时，将重置 Folders 属性。

支持写入的格式，以字符串组成的行向量形式返回。此属性指定使用 writeall 从数据存储写入输出文件时可能的输出格式。

默认输出格式，以字符串标量形式返回。此属性指定使用 writeall 从数据存储写入输出文件时的默认格式。