Файлы, включенные в хранилище данных, разрешенные как массив ячеек символьных векторов или строковый массив, где каждый символьный вектор или строка является полным путем к файлу. location аргумент в tabularTextDatastore и datastore функции определяют эти файлы.

Первый файл, указанный Files определяет имена переменных и информацию о формате для всех файлов в хранилище данных.

При изменении значения этого свойства функция хранилища данных повторно оценивает значения TabularTextDatastore свойства.

Пример: {'C:\dir\data\mydata1.csv';'C:\dir\data\mydata2.csv'}

Типы данных: cell | string

Кодировка файла, заданная как вектор символов или скаляр строки, как одно из этих значений.

Если каждый файл в хранилище данных помещается в память, то FileEncoding также может быть одним из этих значений.

При изменении значения этого свойства функция хранилища данных повторно оценивает значения TabularTextDatastore свойства.

Типы данных: char | string

Считывание имен переменных, указанных как логические true или false.

При изменении значения этого свойства функция хранилища данных повторно оценивает значения TabularTextDatastore свойства.

Типы данных: logical

Флаг для сохранения имен переменных, указанный как разделенная запятыми пара, состоящая из VariableNamingRule и либо 'modify' или 'preserve'.

Начиная с R2019b имена переменных и строк могут содержать любые символы, включая пробелы и символы, не относящиеся к ASCII. Кроме того, они могут начинаться с любых символов, а не только букв. Имена переменных и строк не должны быть допустимыми идентификаторами MATLAB (согласно определению isvarname функция). Чтобы сохранить эти имена переменных и строк, задайте значение VariableNamingRule кому 'preserve'.

Типы данных: char | string

Имена переменных в хранилище данных, указанные как массив ячеек символьных векторов или строковый массив. Укажите имена переменных в порядке их отображения в файлах. Если имена переменных не указаны, они обнаруживаются из первой строки, не являющейся заголовком, в первом файле хранилища данных. При изменении VariableNames , количество новых имен переменных должно совпадать с количеством исходных имен переменных.

Для поддержки недопустимых идентификаторов MATLAB в качестве имен переменных, например имен переменных, содержащих пробелы и символы, не относящиеся к ASCII, задайте значение VariableNamingRule параметр для 'preserve'.

Если ReadVariableNames является false, то VariableNames по умолчанию: {'Var1','Var2', ...}.

Пример: {'Time','Name','Quantity'}

Типы данных: cell | string

Число строк для пропуска в начале файла, указанное как неотрицательное целое число. Если не указано, tabularTextDatastore определяет количество строк для автоматического пропуска.

tabularTextDatastore функция игнорирует указанное количество строк заголовка перед считыванием имен переменных или данных.

При изменении значения этого свойства функция хранилища данных повторно оценивает значения TabularTextDatastore свойства.

Типы данных: double

Символы разделителя полей, указанные как вектор символов, массив ячеек векторов символов, строковый скаляр или строковый массив. Укажите несколько разделителей в массиве ячеек из символьных векторов или в строковом массиве. Если не указано, tabularTextDatastore функция обнаруживает разделитель автоматически.

Пример: '|'

Пример: {';','*'}

Повторяющиеся символы-разделители в файле интерпретируются как отдельные разделители с пустыми полями между ними. Если значение не указано, функция чтения автоматически обнаруживает разделитель по умолчанию.

При указании одной из следующих контрольных последовательностей в качестве разделителя она преобразуется в соответствующий управляющий символ.

При изменении значения этого свойства функция хранилища данных повторно оценивает значения TabularTextDatastore свойства.

Типы данных: char | cell | string

Символ разделителя строки, указанный как вектор символа или скаляр строки, который должен быть либо одним символом, либо одним из '\r', '\n', или '\r\n'.

При изменении значения этого свойства функция хранилища данных повторно оценивает значения TabularTextDatastore свойства.

Пример: ':'

Типы данных: char | string

Текст для обработки как отсутствующие значения, заданный как одиночный вектор, массив ячеек векторов символов, строковый скаляр или строковый массив. Значения указаны как TreatAsMissing заменяются значением, определенным в MissingValue собственность. Например, если MissingValue определяется как NaN, и TreatAsMissing указывается как 'NA'. Затем в импортированных данных все вхождения 'NA' заменены на NaN.

Этот параметр применяется только к числовым полям. Кроме того, это свойство эквивалентно TreatAsEmpty аргумент пары имя-значение для textscan функция.

При изменении значения этого свойства функция хранилища данных повторно оценивает значения TabularTextDatastore свойства.

Пример: 'NA'

Пример: {'-',''}

Типы данных: char | cell | string

Значение для отсутствующих числовых полей в текстовых файлах с разделителями, указанное как скаляр. Это свойство эквивалентно EmptyValue аргумент пары имя-значение для textscan функция.

Типы данных: double

Формат поля данных, заданный как массив ячеек символьных векторов или строковый массив, где каждый символьный вектор или строка содержит один спецификатор преобразования.

При указании или изменении TextscanFormats , можно использовать те же спецификаторы преобразования, что и textscan функция принимает для formatSpec аргумент. Допустимые значения для TextscanFormats включают спецификаторы преобразования, которые пропускают поля, используя символ звездочки (*), и спецификаторы, которые пропускают текст литерала. Количество спецификаторов преобразования должно соответствовать количеству переменных в VariableNames собственность.

Пример: {'%s','%s','%f'}

Типы данных: cell | string

Символы экспоненты, заданные как вектор символов или скаляр строки. Символы степени по умолчанию: e, E, d, и D.

Типы данных: char | string

Символ комментария, используемый для различения комментариев в файле, указанный как символьный вектор, строковый скаляр или двухэлементная строка или массив ячеек.

При чтении из TabularTextDatastore, read функция проверяет наличие комментариев только в начале каждого поля, но не в пределах поля.

При изменении значения этого свойства datastore функция повторно оценивает значения TabularTextDatastore свойства.

Пример: 'CommentStyle',{'/*', '*/'}

Типы данных: char | cell | string

Символы пробела, заданные как вектор символов или скаляр строки из одного или нескольких символов.

При указании одной из следующих переходных последовательностей в качестве любого символа пробела datastore функция преобразует эту последовательность в соответствующий управляющий символ.

При изменении значения этого свойства функция хранилища данных повторно оценивает значения TabularTextDatastore свойства.

Пример: ' \b\t'

Типы данных: char | string

Обработка нескольких разделителей, указанная как true или false. Если true, то datastore обрабатывает последовательные разделители как одиночный разделитель. Повторяющиеся разделители, разделенные пробелом, также рассматриваются как единый разделитель.

При изменении значения этого свойства функция хранилища данных повторно оценивает значения TabularTextDatastore свойства.

Переменные для чтения из файла, заданные как массив ячеек символьных векторов или строковый массив, где каждый символьный вектор или строка содержит имя одной переменной. Имена переменных можно указывать в любом порядке.

Для поддержки недопустимых идентификаторов MATLAB в качестве имен переменных, например имен переменных, содержащих пробелы и символы, не относящиеся к ASCII, задайте значение VariableNamingRule параметр для 'preserve'.

Пример: {'Var3','Var7','Var4'}

Типы данных: cell | string

Форматы выбранных переменных для чтения, заданные как массив ячеек символьных векторов или строковый массив, где каждый символьный вектор или строка содержит один спецификатор преобразования. Считываемые переменные обозначаются SelectedVariableNames собственность. Число символьных векторов или строк в SelectedFormats должно соответствовать числу читаемых переменных.

Можно использовать те же спецификаторы преобразования, что и textscan принимает, включая спецификаторы, пропускающие текст литерала. Однако нельзя использовать спецификатор преобразования, пропускающий поле. То есть спецификатор преобразования не может включать символ звездочки (*).

Пример: {'%d','%d'}

Типы данных: cell | string

Объем данных для чтения при вызове read функция, заданная как положительный скаляр или 'file'.

При изменении ReadSize из числового скаляра в 'file' или наоборот, MATLAB сбрасывает хранилище данных в состояние, в котором данные из него не считывались.

Типы данных: double | char | string

Тип выходных данных текстовых переменных, указанный как 'char' или 'string'. TextType указывает тип данных текстовых переменных, отформатированных с помощью %s, %q, или [...].

Типы данных: char | string

Имя переменной времени строки, указанной как разделенная запятыми пара, состоящая из 'RowTimes' и имя переменной (например, "Date") или индекс переменной (например, 3).

RowTimes является параметром, связанным с расписанием. Каждая строка расписания связана с временем, которое фиксируется в векторе времени для расписания. Переменная, указанная в RowTimes должен содержать datetime или duration вектор.

Если значение 'OutputType' является 'timetable', но вы не указываете 'RowTimes', то TabularTextDatastore использует первый datetime или duration переменная в качестве времени строки для расписания.

Это свойство доступно только для чтения.

Папки, используемые для создания хранилища данных, возвращаемого в виде массива ячеек символьных векторов. Массив ячеек ориентирован как вектор-столбец. Каждый вектор символов - это путь к папке, содержащей файлы данных. location аргумент в tabularTextDatastore и datastore функции определяют Folders при создании хранилища данных.

Folders сбрасывается при изменении Files свойство TabularTextDatastore объект.

Типы данных: cell

Это свойство доступно только для чтения.

Список форматов, поддерживаемых для записи, возвращаемый в виде вектора строк. Это свойство задает возможные форматы вывода при использовании writeall для записи выходных файлов из хранилища данных.

Типы данных: string

Это свойство доступно только для чтения.

Формат вывода по умолчанию, возвращаемый как строковый скаляр. Это свойство задает формат по умолчанию при использовании writeall для записи выходных файлов из хранилища данных.

Типы данных: string