主要内容

writeall

写数据存储文件

自从R2020a

描述

例子

writeall (ds,outputLocation)写输入数据存储的数据ds输出文件中指定的位置outputLocation。输出文件的数量是一样的文件引用的数据存储的数量。

例子

writeall (ds,outputLocation,名称,值)写数据和附加选项指定一个或多个名称-值对参数。例如,您可以指定“OutputFormat”和一个文件扩展名等“csv”指定的文件的类型writeall创建。

例子

全部折叠

写一个数据存储到磁盘,然后创建一个新的数据存储的书面文件。这个过程有助于节省你的工作或与同事共享一个数据存储。

创建一个数据存储airlinesmall.csv数据集,治疗“NA”价值观缺失的数据。只选择了一年,,航空公司变量。

ds =数据存储(“airlinesmall.csv”);ds。TreatAsMissing =“NA”;ds。SelectedVariableNames = {“月”,“年”,“UniqueCarrier”};

预览数据存储。

预览(ds)
ans =8×3表月UniqueCarrier _____ _____ _________________ 10 1987年{“PS”} 1987 {“PS”} 1987 {“PS”} 1987 {“PS”} 1987 {“PS”} 1987 {“PS”} 1987 {“PS”} 1987 {“PS”}

保存这个数据存储到一个新文件夹命名ExampleDataC: \磁盘。(您可以指定一个不同的位置写,特别是如果你不使用Windows®计算机)。指定“FolderLayout”作为“平”直接把数据存储文件的目标文件夹,不创建子文件夹。

位置=“C: \ ExampleData”;writeall (ds、位置“Folderlayout”,“平”)

清晰的ds从你的工作目录。从磁盘恢复数据存储,创建一个新的数据存储引用数据是相同的文件夹中。

清晰的dsds2 =数据存储(位置);

写一个数据存储文件时,您可以选择重复或扁平结构通过设置的文件夹“FolderLayout”参数。创建一个图像数据存储从输入位置,然后把数据存储到文件中。接下来,编写文件的输出位置通过复制文件夹布局。最后,写的文件作为一个平面列表输出位置。

创建一个图像数据存储的位置'输入C: \ \ ',其中包含一些汽车和火车的照片:

imd = imageDatastore ('输入C: \ \ ',“IncludeSubfolders”,真正的);

这个文件夹结构就是一个例子。你可以试着与一个文件夹的功能结构包含图像文件在您的机器上。

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

imds.Folders
ans = 1×1单元阵列{'输入C: \ \ '}

把数据存储到输出位置“C: \ \输出”。默认值的“FolderLayout”参数是“复制”。因此,writeall功能重复所有的文件夹中文件夹属性输入的数据存储,然后将文件写到相应的输出文件夹。

writeall (imd,“C: \ \输出”);

现在,写文件数据存储的输出位置“C: \ \输出”作为一个平通过设置列表“FolderLayout”“平”。在这种情况下,writeall函数不保存输入文件夹布局,而是将所有的文件写入平面输出位置。

writeall (imd,“C: \ \输出”,“FolderLayout”,“平”);

有关更多信息,请参见FolderLayout

您可以使用FilenamePrefixFilenameSuffix参数将文本添加到输出文件的开头或结尾的名字。创建一个图像数据存储从输入位置。把数据存储到文件和文本附加到文件名的开始。然后再写数据存储并将文本附加到文件的末尾的名字。

创建一个图像数据存储的位置'输入C: \ \ ',其中包含一些汽车和火车的照片:

imd = imageDatastore ('输入C: \ \ ',“IncludeSubfolders”,真正的);

这个文件夹结构就是一个例子。你可以试着与一个文件夹的功能结构包含图像文件在您的机器上。

现在,写文件到一个输出位置。指定的值FilenamePrefix作为“png_”添加文本的每个输出文件名。

writeall (imd,“C: \ \输出”,“FilenamePrefix”,“png_”);

写文件到不同的输出位置。指定的值FilenameSuffix作为“_image”添加文本的每个输出文件名。

writeall (imd,“C: \ output2 \”,“FilenameSuffix”,“_image”);

输入参数

全部折叠

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

你也可以使用这些数据存储writeall如果你提供的“OutputFormat”“WriteFcn”名称-值对:

文件夹位置写数据,指定为一个特征向量或字符串标量。outputLocation可以指定一个完整或相对路径。

例子:outputLocation =“. . / . . / dir /数据”

例子:outputLocation = " C: \ \名字\用户桌面”

数据类型:字符|字符串

名称-值参数

指定可选的双参数作为Name1 = Value1,…,以=家,在那里的名字参数名称和吗价值相应的价值。名称-值参数必须出现在其他参数,但对的顺序无关紧要。

R2021a之前,用逗号来分隔每一个名称和值,并附上的名字在报价。

例子:writeall (ds, outputLocation FolderLayout’,‘平’)

一般选择

全部折叠

输出文件格式,指定为逗号分隔组成的“OutputFormat”和一个字符向量或字符串标量。

基于输入数据存储的类型ds输出文件,选择其中一个值。您可以选择任何表格输出格式的下面列出的表格数据存储。

输入数据存储

输出格式

TabulartextDatastore,SpreadsheetDatastore,ParquetDatastore “三”,“csv”,“xlsx”,“xls”,“铺”,或“parq”
ImageDatastore “png”,“jpg”,“jpeg”,气管无名动脉瘘管的' ',或“饮”
AudioDatastore “wav”,“ogg”,“flac”,“mp4”,或“m4a格式”
FileDatastore,TransformedDatastore,CombinedDatastore,SequentialDatastore 所有支持的输出格式。万博1manbetx

对于一些输出格式,有额外的名称-值对,您可以使用它们来改进写操作。

输出格式 名称-值对

jpeg,jpg

“质量”

wav,flac

“BitsPerSample”

mp4,m4a格式

“比特率”

三种,csv

“WriteVariableNames”

“分隔符”

编码

“QuoteStrings”

xls,xlsx

“表”

数据类型:字符|字符串

在输出文件夹布局文件,指定为逗号分隔组成的“FolderLayout”,要么“复制”“平”

  • “复制”- - -writeall函数复制文件夹结构中包含输入数据位置指定的输出位置。输入数据包含了位置文件夹输入数据存储的属性。

  • “平”- - -writeall函数将从输入的所有文件写入指定输出文件夹没有任何子文件夹。

数据类型:字符|字符串

文件名前缀,指定为逗号分隔组成的“FilenamePrefix”和一个字符向量或字符串标量。

writeall函数将指定前缀添加到输出文件的名字。例如,这段代码添加了今天的日期开始的所有输出文件名称数据存储:

prefixText =字符串(datetime (“今天”)writeall (imd,“C: \ myFolder”,“FilenamePrefix”,prefixText);

数据类型:字符|字符串

文件名后缀,指定为逗号分隔组成的“FilenameSuffix”和一个字符向量或字符串标量。

writeall函数将指定的后缀添加到输出文件的名字。例如,这段代码添加描述性文本“jpeg_70per”到最后数据存储的所有输出文件名称:

writeall (imd,“C: \ myFolder”,“FilenameSuffix”,“jpeg_70per”);

数据类型:字符|字符串

指标编写并行,指定为逗号分隔组成的“UseParallel”,要么真正的(01)。

默认情况下writeall在系列中写道。如果你设置UseParallel真正的,然后writeall写操作分为独立的组织和并行运行组如果:

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

  • 开放平行池存在或自动池创建启用了在并行的偏好。

否则,writeall在串行不管值中写道UseParallel

writeall通过本地不支持编写万博1manbetx并行线程。

请注意

并行写不支持万博1manbetxCombinedDatastore对象,或造成数据存储变换应用于CombinedDatastore

数据类型:逻辑

自定义编写函数,指定为逗号分隔组成的“WriteFcn”和一个函数处理。指定的功能是负责创建输出文件。

您可以使用“WriteFcn”名称-值对论点写各种格式的数据,即使writeall不直接支持的输出格式。万博1manbetx

函数签名

自定义编写函数必须接受至少有三个输入参数,数据,writeInfo,outputFormat:

函数myWriteFcn(数据、writeInfo outputFormat)
函数也可以接受额外的输入,如名称-值对,前三后需要输入。

  • 数据包含的输出操作的数据存储方法。

  • writeInfo是一个类型的对象matlab.io.datastore.WriteInfo表中列出的字段。

    描述 类型
    ReadInfo 第二个的输出方法 结构体
    SuggestedOutputName 完全限定,全局唯一满足的位置和文件名的命名要求 字符串
    位置 参数传递给数据存储位置写 字符串
  • outputFormat输出格式编写,例如“三”“csv”

例子函数

一个写函数,拼花从数据存储文件写道:

函数myParquetWriteFcn(数据、writeInfo outputFormat)如果比较字符串(outputFormat“铺”)parquetwrite (writeInfo.SuggestedOutputName数据)结束结束
调用myParquetWriteFcn作为一个数据存储写函数ds使用这些命令:
ds = parquetDatastore(位置);outputLocation =“C: / tmp / MyData”;writeall (ds, outputLocation“WriteFcn”,@myParquetWriteFcn);

数据类型:function_handle

选项jpegjpg输出

全部折叠

JPEG-compressed质量文件,指定为逗号分隔组成的“质量”和一个标量范围[0100],0是低质量和更高的压缩,和100年更高的质量和更低的压缩。

例子:“质量”,25岁

选项wavflac输出

全部折叠

输出位/样本数量,指定为逗号分隔组成的“BitsPerSample”8,16,24,32,或64年

仅供FLAC文件8,16,或24位/样品支持。万博1manbetx

例子:“BitsPerSample”, 32

选项mp4m4a格式输出

全部折叠

千比特/秒(kbit / s)用于压缩音频文件,指定为逗号分隔组成的“比特率”64年,96年,128年,160年,192年,256年,或320年。在窗户®7或之后,唯一有效的值是:96年,128年,160年,192年

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

例子:“比特率”,96年

选项三种csv输出

全部折叠

指标编写变量名作为列标题,指定为逗号分隔组成的“WriteVariableNames”,要么真正的

指示器

行为

真正的

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

写函数并不包括在输出变量名。

字段分隔符字符,指定为逗号分隔组成的“分隔符”和一个特征向量或字符串标量包含其中一个说明符:

说明符

字段分隔符

”、“

“逗号”

逗号。这是默认的行为。

' '

“空间”

空间

' \ t '

“标签”

选项卡

“;”

“半”

分号

“|”

“酒吧”

竖线

您可以使用“分隔符”名称-值对只对分隔的文本文件。

例子:“分隔符”、“空间”

数据类型:字符|字符串

字符编码方案相关文件,指定为逗号分隔组成的“编码”“系统”或一个标准字符编码方案的名字像这个表中的值之一。当你不指定任何编码或指定编码“系统”,写函数使用系统默认编码写文件。

“繁体”

“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”

“us - ascii”

“麦金塔”

“utf - 8”

“Shift_JIS”

例子:“utf - 8”

数据类型:字符|字符串

指标写引用文本,指定为“最低”,“所有”,或“没有”

  • 如果QuoteStrings“最低”,那么这个函数包含任何变量包含分隔符,行结束,在双引号字符或双引号字符。

  • 如果QuoteStrings“所有”,那么这个函数包含所有文本、分类、datetime,和持续时间变量在双引号字符。

  • 如果QuoteStrings“没有”,那么函数不附上变量在双引号字符。

您可以使用QuoteStrings名称-值参数只有分隔的文本文件。

选项xlsxlsx输出

全部折叠

工作表写,指定为逗号分隔组成的“表”和一个特征向量或一个字符串标量包含工作表名称或一个正整数表示工作表索引。工作表名称不能包含冒号(:)。确定的名称表电子表格文件,使用表= sheetnames(文件名)。有关更多信息,请参见sheetnames

指定工作表写的名字或指数:

  • 名——如果指定表名不存在的文件,然后编写函数的末尾添加一个新表工作表集合。

  • 指数——如果索引指定表索引大于工作表的数量,然后写函数附加空表,直到工作表的工作簿的数量等于表索引。写函数还生成一个警告,表明它已经添加了一个新的工作表。

您可以使用“表”只与电子表格文件名称-值对。

例子:“表”,2

例子:“表”,“MySheetName”

数据类型:字符|字符串|||int8|int16|int32|int64|uint8|uint16|uint32|uint64

扩展功能

版本历史

介绍了R2020a