Тип файла, заданного как пара, разделенная запятой, состоящая из 'FileType' и одни из позволенных типов файлов: 'auto', 'mat', 'parquet', 'seq', 'text' или 'spreadsheet'.

Используйте пару "имя-значение" 'FileType' с аргументом location, чтобы задать какой файлы, чтобы записать. По умолчанию write пытается автоматически обнаружить соответствующий тип файла. Вы не должны задавать аргумент пары "имя-значение" 'FileType', если write может определить тип файла от расширения в аргументах location или filepattern. write может определить тип файла от этих расширений:

Пример: write('C:\myData', D, 'FileType', 'text')

Пользовательская функция записи, заданная как пара, разделенная запятой, состоящая из 'WriteFcn' и указателя на функцию. Заданная функция получает блоки данных от D и ответственна за создание выходных файлов. Можно использовать аргумент пары "имя-значение" 'WriteFcn', чтобы записать данные во множестве форматов, даже если выходной формат непосредственно не поддержан write.

Функциональная подпись

Пользовательская функция записи должна принять два входных параметра, info и data:

function myWriter(info, data)

Именование файла

Имя файла, используемое для выходных файлов, определяет порядок, что файлы читаются, въезжают задним ходом позже datastore. Если порядок вопросов файлов, то лучшая практика состоит в том, чтобы использовать поле SuggestedFilename, чтобы назвать файлы начиная с предложенного имени, гарантирует порядок файла. Если вы не используете предложенное имя файла, пользовательская функция записи должна создать глобально уникальный, правильно упорядоченные имена файлов. Имена файлов должны следовать за шаблоном именования, обрисованным в общих чертах в RequiredFilePattern. Имена файлов должны быть уникальными и правильно упорядоченные между рабочими, даже при том, что каждый рабочий пишет в его собственную локальную папку.

Массивы с несколькими разделами

Распределенный массив разделен на разделы, чтобы упростить выполняющие вычисления на массиве параллельно с Parallel Computing Toolbox™. При записи распределенного массива каждый из разделов разделен на меньшие блоки.

info содержит несколько полей, связанных с разделами: PartitionIndex, NumPartitions, BlockIndexInPartition и IsFinalBlock. Эти поля полезны, когда вы выписываете один файл и добавляете к нему, который является общей задачей для массивов с большими разделами, которые были разделены во многие блоки. Пользовательская функция записи вызвана однажды на блок, и блоки в одном разделе всегда пишутся по порядку на одном рабочем. Однако различные разделы могут быть записаны различными рабочими.

Функция, взятая в качестве примера,

Простая функция записи, которая выписывает файлы электронной таблицы:

function dataWriter(info, data)
  filename = info.SuggestedFilename;
  writetable(data, filename, 'FileType', 'spreadsheet')
end

D = distributed(array2table(rand(5000,3)));
location = '/tmp/MyData/D_*.xlsx';
write(location, D, 'WriteFcn', @dataWriter);

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

Индикатор для записи имен переменных как заголовки столбцов, заданные как пара, разделенная запятой, состоящая из 'WriteVariableNames' и числового или логического 1 (true) или 0 (false).

Локаль для записи дат, заданных как пара, разделенная запятой, состоящая из 'DateLocale' и вектора символов или скаляра строки. При записи значений datetime в файл используйте DateLocale, чтобы задать локаль, в которой write должен написать имена месяца и дня недели и сокращения. Вектор символов или строка принимают форму xx_YY, где xx является строчный ISO 639-1 двухбуквенный код, указывающий на язык, и YY является прописной альфой ISO 3166-1 2 кода, указывающие на страну. Для списка общих ценностей для локали смотрите аргумент пары "имя-значение" Locale для функции datetime.

Для файлов Excel^® write пишет переменные, содержащие массивы datetime как даты Excel, и игнорирует значение параметров 'DateLocale'. Если переменные datetime содержат годы или до 1 900 или до 1904, то write пишет переменные как текст. Для получения дополнительной информации о датах Excel смотрите Различия между 1900 и 1 904 системами дат в Excel.

Пример: 'DateLocale','ja_JP' или 'DateLocale',"ja_JP"

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

Символ разделителя полей, заданный как пара, разделенная запятой, состоящая из 'Delimiter' и один из этих спецификаторов:

Можно использовать аргумент пары "имя-значение" 'Delimiter' только для файлов разделенного текста.

Пример: 'Delimiter','space' или 'Delimiter',"space"

Индикатор для записи заключенного в кавычки текста, заданного как пара, разделенная запятой, состоящая из 'QuoteStrings' и или false или true. Если 'QuoteStrings' является true, то write заключает текст в двойные кавычки и заменяет любые символы двойной кавычки, которые появляются как часть того текста с двумя символами двойной кавычки. Для примера смотрите Запись Заключенный в кавычки текст к файлу CSV (MATLAB).

Можно использовать аргумент пары "имя-значение" 'QuoteStrings' только с файлами разделенного текста.

Схема кодировки символов, сопоставленная с файлом, заданным как пара, разделенная запятой, состоящая из 'Encoding' и 'system' или схемы кодирования стандартного символа, называет как одно из значений в этой таблице. Когда вы не задаете кодирования или задаете кодирование как 'system', функция write использует ваше кодирование системного значения по умолчанию, чтобы записать файл.

Пример: 'Encoding','system' или 'Encoding',"system" используют кодирование системного значения по умолчанию.

Целевой рабочий лист, заданный как пара, разделенная запятой, состоящая из 'Sheet' и вектора символов или скаляра строки, содержащего имя рабочего листа или положительное целое число, указывающее на индекс рабочего листа. Имя рабочего листа не может содержать двоеточие (:). Чтобы определить имена листов в файле электронной таблицы, используйте [status,sheets] = xlsfinfo(filename).

Если лист не существует, то write добавляет новый лист в конце набора рабочего листа. Если лист является индексом, больше, чем количество рабочих листов, то write добавляет пустые листы, пока количество рабочих листов в рабочей книге не равняется индексу листа. В любом случае write генерирует предупреждение, указывающее, что это добавило новый рабочий лист.

Можно использовать аргумент пары "имя-значение" 'Sheet' только с файлами электронной таблицы.

Пример: 'Sheet', 2

Пример: 'Sheet', 'MySheetName'

Типы данных: char | string | single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Устелите паркетом алгоритм сжатия, заданный как одно из этих значений.

В целом сжатие 'Snappy' имеет лучшую производительность для чтения и записи, в то время как 'Brotli' обычно производит меньший размер файла.

Пример: write('C:\myData',D,'FileType','parquet','VariableCompression','Brotli')