主要内容

reliteall.

将数据存储写入文件

描述

例子

Writeall(DS.输出位置从输入数据存储中写下数据DS.在指定的位置输出文件输出位置。输出文件的数量与数据存储引用的文件数相同。

例子

Writeall(DS.输出位置名称,价值用一个或多个名称值对参数指定的附加选项写入数据。例如,您可以指定'OutputType'和一个文件扩展名,如'csv'指定文件的类型reliteall.创造。

例子

全部收缩

将数据存储区写入磁盘,然后为书面文件创建新数据存储。此过程可用于保存您的工作或与同事共享数据存储。

创建一个数据存储区Airlinesmall.csv.数据集,治疗'na'值作为缺失数据。只选择它, 和载体变量。

ds =数据存储('airlinesmall.csv');ds.treatasmissing ='na';ds.selectedvariablenames = {'月''年''unqueCarrier'};

预览数据存储。

预览(DS)
ans =.8×3表月年Unquecarrier ______________________ 10 1987 {'PS'} 10 1987 {'PS'} 10 1987 {'PS'} 10 1987 {'PS'} 10 1987 {'PS'} 10 1987{'ps'} 10 1987 {'ps'}

将此数据存储区保存到名为的新文件夹exampledata.在这一点C:\磁盘。(您可以指定不同的写入位置,特别是如果您未使用Windows®计算机。)指定'flocklayout'作为'扁平'要将数据存储区文件直接放在目标文件夹中,而无需创建子文件夹。

位置='c:\ exampledata';WRITEALL(DS,位置,'flocklayout''扁平'

清除DS.来自您的工作目录。要从磁盘恢复数据存储,请创建一个新的数据存储,引用编写数据的相同文件夹。

清除DS.DS2 =数据存储(位置);

在将数据存储区写入文件时,您可以选择通过设置来复制或达成文件夹结构'flocklayout'范围。从输入位置创建图像数据存储,然后将数据存储写入文件。接下来,通过重复文件夹布局,在输出位置写入文件。最后,将文件写为平面列表到输出位置。

从该位置创建图像数据存储'c:\输入',其中包含一些汽车和火车的图像:

imds = imageageatastore('c:\输入''insertumbfolders',真的);

此文件夹结构只是一个例子。您可以尝试使用计算机上包含图像文件的文件夹结构的功能。

检查文件夹输入数据存储的属性,其中包含输入数据集的完全限定路径。

imds.folders.
ans = 1×1个单元阵列{'c:\输入\'}

将数据存储区写入输出位置'C:\ output \'。默认值'flocklayout'参数是'复制'。因此,这是reliteall.函数重复所有包含的文件夹文件夹输入数据存储的属性,然后将文件写入相应的输出文件夹。

令人武女士(IMDS,'C:\ output \');

现在,将文件从数据存储区写入输出位置'C:\ output \'通过设置作为平面列表'flocklayout''扁平'。在这种情况下,reliteall.函数不保留输入文件夹布局,而是将所有文件写入扁平输出位置。

令人武女士(IMDS,'C:\ output \''flocklayout''扁平');

有关更多信息,请参阅folderlayout.

你可以使用filenameprefix.filenamesuffix.参数将文本添加到输出文件名的开头或结尾。从输入位置创建图像数据存储。将数据存储区写入文件并将文本追加到文件名的开头。然后再次编写数据存储,并将文本追加到文件名的末尾。

从该位置创建图像数据存储'c:\输入',其中包含一些汽车和火车的图像:

imds = imageageatastore('c:\输入''insertumbfolders',真的);

此文件夹结构只是一个例子。您可以尝试使用计算机上包含图像文件的文件夹结构的功能。

现在,将文件写入输出位置。指定值filenameprefix.作为'png_'将该文本追加到每个输出文件名的开头。

令人武女士(IMDS,'C:\ output \''filenameprefix''png_');

将文件写入其他输出位置。指定值filenamesuffix.作为'_图像'将该文本追加到每个输出文件名的末尾。

令人武女士(IMDS,'c:\ output2 \''filenamesuffix''_图像');

输入参数

全部收缩

输入数据存储。您可以使用这些数据存储作为输入reliteall.

您还可以使用这些数据存储reliteall.如果您提供提供的'输出格式'或者'writefcn'名称值对:

文件夹位置写入数据,指定为字符向量或字符串标量。输出位置可以指定完整或相对路径。

例子:OpertalLocation ='../../dir/data'

例子:OperationLocation =“C:\ Users \ MyName \ Desktop”

数据类型:char|细绳

名称值对参数

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

例子:writeall(DS,OutputLocation,'folderLayout','flatten')
常规选项

全部收缩

输出文件格式,指定为逗号分隔对组成'输出格式'和一个字符矢量或字符串标量。

基于输入数据存储的类型DS.,为输出文件选择以下值之一。您可以为下面列出的任何表格数据存储选择任何表格输出格式。

输入数据存储

输出格式

tabulartextdatastore.SpreadsheetDatastore.帕奎特adatastore. '文本文件''csv''xlsx''xls''镶木地板', 或者'Parq'
imageageAtastore. 'PNG''jpg''jpeg''tif', 或者'tiff'
audiodatastore. “wav”'ogg''flac''mp4', 或者'm4a'
filedatastore.变换adatastore.ConventDatastore. 支持所有输出格式。万博1manbetx

对于某种输出格式,您可以使用其他名称 - 值对来优化写入操作。

输出格式 名称 - 值对

JPEG.jpg.

'质量'

FLAC.

'bitspersample'

MP4.M4A.

'比特率'

文本文件CSV

'writevariamblenames'

'delimiter'

'编码'

“推广”

XLS.XLSX.

'床单'

数据类型:char|细绳

输出文件夹中的文件布局指定为逗号分隔对组成'flocklayout'和任何一种'复制'或者'扁平'

  • '复制'- 这reliteall.函数将输入数据位置中包含的文件夹结构复制到指定的输出位置。输入数据位置包含文件夹输入数据存储的属性。

  • '扁平'- 这reliteall.函数将输入的所有文件写入到指定的输出文件夹,没有任何子文件夹。

数据类型:char|细绳

到文件名的前缀,指定为逗号分隔的配对组成'filenameprefix'和一个字符矢量或字符串标量。

reliteall.函数将指定的前缀添加到输出文件名。例如,此代码从数据存储区中添加了今天的所有输出文件名的日期:

prefixtext = string(datetime('今天​​'))writeall(IMDS,'c:\ myfolder''filenameprefix',prefixtext);

数据类型:char|细绳

文件名的后缀,指定为逗号分隔对组成'filenamesuffix'和一个字符矢量或字符串标量。

reliteall.函数将指定的后缀添加到输出文件名。例如,此代码添加了描述性文本'jpeg_0per'从数据存储区到所有输出文件名的末尾:

令人武女士(IMDS,'c:\ myfolder''filenamesuffix''jpeg_0per');

数据类型:char|细绳

指标并行写入,指定为逗号分隔对'使用指平行'和任何一种错误的或者真的0.或者1)。

默认reliteall.在序列中写道。如果你设置了使用指α.真的, 然后reliteall.将写入操作划分为单独的组,如果以下情况,则并行运行组:

  • 安装并行计算工具箱™。

  • 存在打开的并行池或在并行首选项中启用自动池创建。

除此以外,reliteall.无论价值如何,串行写入使用指α.

笔记

不支持并行写作万博1manbetxConventDatastore.由此产生的对象或数据存储转换适用于A.ConventDatastore.

数据类型:逻辑

定制写作函数,指定为逗号分隔对组成'writefcn'和一个功能手柄。指定的函数负责创建输出文件。

你可以使用'writefcn'名称 - 值对参数以各种格式写入数据,即使reliteall.不直接支持输出格式。万博1manbetx

功能签名

自定义写入函数必须接受至少三个输入参数,数据writeinfo., 和OutputType.

功能mywritefcn(数据,writeinfo,outputtype)
在前三个所需输入之后,该功能还可以接受额外的输入,例如名称值对。

  • 数据包含输出的输出方法在数据存储上运行。

  • writeinfo.是一种类型的对象matlab.io.datastore.writeinfo.使用表中列出的字段。

    场地 描述 类型
    readInfo. 第二个输出方法 塑造
    buildedoutputname. 满足位置和命名要求的完全合格的全局唯一文件名 细绳
    地点 位置参数传递给Datastore Write 细绳
  • OutputType.例如要写入的输出格式是“文本文件”或者“CSV”

示例功能

从数据存储区写下镶嵌文件的写作函数是:

功能myparquetwritefcn(数据,writeinfo,outputtype)如果Strcmp(OutputType,“镶木地板”)ParqueTwrite(writeInfo.suggestedOutputPutname,Data)结尾结尾
调用myparquetwritefcn.作为数据存储的写作函数DS.,使用这些命令:
DS = Parquetdatastore(地点);OutputLocation =.'c:/ tmp / mydata';WRITEALL(DS,OutputLocation,'writefcn',@ myparquetwritefcn);

数据类型:function_handle.

选择JPEG.或者jpg.输出

全部收缩

JPEG压缩文件的质量,指定为逗号分隔对组成'质量'并且在[0,100]范围内的标量,其中0是较低的质量和更高的压缩,100质量更高,压缩更低。

例子:'质量',25

选择或者FLAC.输出

全部收缩

每个样本的输出位数,指定为逗号分隔的对'bitspersample'8.16.24.32., 或者64.

仅限FLAC文件8.16., 或者24.支持每个样本的比特。万博1manbetx

例子:'bitspersample',32

选择MP4.或者M4A.输出

全部收缩

用于压缩音频文件的每秒千比特数(Kbit / s),指定为包含的逗号分隔对'比特率'64.96.128.160.192.256., 或者320.。上视窗®7.或者以后,唯一有效的值是:96.128.160., 和192.

一般来说,一个更大的比特拉特值导致更高的压缩质量。

例子:'比特率',96

选择文本文件或者CSV输出

全部收缩

用于将变量名称作为列标题的指示符,指定为逗号分隔对'writevariamblenames'和任何一种真的或者错误的

指标

行为

真的

写入函数包括作为输出列标题的变量名称。这是默认行为。

错误的

写入功能不包括输出中的变量名称。

字段分隔符,指定为逗号分隔对组成'delimiter'和一个字符向量或字符串标量,包含其中一个说明符:

说明书

字段分隔符

','

'逗号'

逗号。这是默认行为。

''

'空间'

空间

'\ t'

'标签'

标签

';'

'半'

分号

'|'

'酒吧'

垂直条

你可以使用'delimiter'名称值对仅用于分隔文本文件。

例子:'delimiter','space'

数据类型:char|细绳

与文件相关联的字符编码方案,指定为包含的逗号分隔对'编码''系统'或标准字符编码方案名称,如此表中的其中一个值。当您未指定任何编码或指定编码时'系统',写入功能使用您的系统默认编码来编写文件。

'Big5'

'ISO-8859-1'

'Windows-874'

'big5-hkscs'

'ISO-8859-2'

'Windows-949'

'cp949'

'ISO-8859-3'

'Windows-1250'

'euc-kr'

'ISO-8859-4'

'Windows-1251'

'euc-jp'

'ISO-8859-5'

'Windows-1252'

'euc-tw'

'ISO-8859-6'

'Windows-1253'

'GB18030'

'ISO-8859-7'

'Windows-1254'

'GB2312'

'ISO-8859-8'

'Windows-1255'

'GBK'

'ISO-8859-9'

'Windows-1256'

'IBM866'

'ISO-8859-11'

'Windows-1257'

'koi8-r'

'ISO-8859-13'

'Windows-1258'

'koi8-u'

'ISO-8859-15'

'美国 - ascii'

'Macintosh'

'UTF-8'

'shift_jis'

例子:'UTF-8'

数据类型:char|细绳

写入引用文本的指示,指定为逗号分隔对“推广”和任何一种错误的或者真的。如果“推广”真的然后,写入函数用双引号中的文本包装在双引号中,并替换任何作为该文本的一部分具有两个双引号字符的双引号字符。

你可以使用“推广”名称值对仅使用分隔文本文件。

选择XLS.或者XLSX.输出

全部收缩

写入的工作表,指定为逗号分隔的配对'床单'和一个字符向量或包含工作表名称的字符串标量或显示工作表索引的正整数。工作表名称不能包含冒号()。确定电子表格文件中的纸张名称,使用表格= SheetNames(文件名)。有关更多信息,请参阅张贴名录

指定要按名称或索引写入的工作表:

  • name - 如果文件中指定的工作表名称不存在,则写入函数在工作表集合的末尾添加新表。

  • 索引 - 如果指定的纸张索引是索引大于工作表的数量,则写入函数追加空工作表,直到工作簿中的工作表数量等于纸张索引。写入功能还生成警告,指示它已添加新工作表。

你可以使用'床单'名称值对仅使用电子表格文件。

例子:'床单'2

例子:'床单''mysheetname'

数据类型:char|细绳|单身的|双倍的|INT8.|int16|INT32.|INT64.|uint8.|uint16|UINT32|UINT64

扩展能力

在R2020A中介​​绍