write

文件类型，指定为以逗号分隔的对，由 'FileType' 和以下允许的文件类型之一组成：'auto'、'mat'、'parquet'、'seq'、'text' 或 'spreadsheet'。

使用 'FileType' 名称-值对和 location 参量来指定要写入的文件类型。默认情况下，write 会尝试自动检测正确的文件类型。如果 'FileType' 可以根据 location 或 filepattern 参量中的扩展名确定文件类型，则无需指定 write 名称-值对参量。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);

将变量名称写为列标题的指示符，指定为由 'WriteVariableNames' 和数值或逻辑 1 (true) 或 0 (false) 组成的逗号分隔的对。

用于编写日期的语言环境，指定为由 'DateLocale' 和字符向量或字符串标量组成的逗号分隔的对。将 datetime 值写入文件时，使用 DateLocale 指定 write 应写入月份和星期名称及缩写的区域设置。字符向量或字符串采用 xx_YY 的形式，其中 xx 是表示语言的小写 ISO 639-1 双字母代码，YY 是表示国家/地区的大写 ISO 3166-1 alpha-2 代码。有关语言环境的常用值的列表，请参阅 datetime 函数的 Locale 名称-值对参量。

对于 Excel^® 文件，write 将包含 datetime 数组的变量写入为 Excel 日期，并忽略 'DateLocale' 参数值。如果 datetime 变量包含 1900 年或 1904 年之前的年份，则 write 会将变量写入文本。有关 Excel 日期的更多信息，请参阅 Excel 中 1900 和 1904 日期系统之间的差异。

示例: 'DateLocale','ja_JP' 或 'DateLocale',"ja_JP"

字段分隔符，指定为由 'Delimiter' 和以下设定符之一组成的逗号分隔对：

您只能对分隔文本文件使用 'Delimiter' 名称-值对参量。

示例: 'Delimiter','space' 或 'Delimiter',"space"

用于写入引用文本的指示符，指定为由 'QuoteStrings' 和 false 或 true 组成的逗号分隔的对。如果 'QuoteStrings' 是 true，则 write 将文本括在双引号中，并用两个双引号字符替换作为该文本一部分出现的任何双引号字符。有关示例，请参阅 将引用文本写入 CSV 文件。

您只能在带分隔符的文本文件中使用 'QuoteStrings' 名称-值对参量。

与文件关联的字符编码方案，指定为由 'Encoding' 和 'system' 组成的逗号分隔的对或标准字符编码方案名称，类似于此表中的一个值。当您没有指定任何编码或者指定编码为 'system' 时，write 函数将使用系统默认编码来写入文件。

示例: 'Encoding','system' 或 'Encoding',"system" 使用系统默认编码。

目标工作表，指定为以逗号分隔的对，由 'Sheet' 和一个字符向量或包含工作表名称或表示工作表索引的正整数的字符串标量组成。工作表名称不能包含冒号 (:)。要确定电子表格文件中工作表的名称，请使用 [status,sheets] = xlsfinfo(filename)。

如果工作表不存在，则 write 会在工作表集合的末尾添加一个新工作表。如果工作表的索引大于工作表的数量，则 write 会附加空工作表，直到工作簿中的工作表数量等于工作表索引。无论哪种情况，write 都会生成一个警告，表明它已添加了新的工作表。

您只能在电子表格文件中使用 'Sheet' 名称-值对参量。

示例: 'Sheet',2

示例: 'Sheet'、'MySheetName'

Parquet 压缩算法，指定为这些值之一。

总体来说，'snappy' 的读写性能更佳；'gzip' 的压缩率更高但需要更多的 CPU 处理时间；'brotli' 通常可以产生最小的文件大小但压缩速度较慢。

示例: write('C:\myData',D,'FileType','parquet','VariableCompression','brotli')

示例: write('C:\myData', D, 'FileType', 'parquet', 'VariableCompression', {'brotli' 'snappy' 'gzip'})

编码方案名称，指定为以下值之一：

一般来说，'dictionary' 编码会产生较小的文件大小，但对于不包含许多重复值的变量，'plain' 编码的速度会更快。如果字典的大小或唯一值的数量变得太大，那么编码会自动恢复为普通编码。有关 Parquet 编码的更多信息，请参阅 Parquet 编码定义。

示例: write('myData.parquet', D, 'FileType', 'parquet', 'VariableEncoding', 'plain')

示例: write('myData.parquet', D, 'FileType', 'parquet', 'VariableEncoding', {'plain' 'dictionary' 'plain'})

要使用的 Parquet 版本，指定为 '1.0' 或 '2.0'。默认情况下，'2.0' 提供最有效的存储，但您可以选择 '1.0' 以实现与支持 Parquet 格式的外部应用程序的最广泛兼容性。