writeall
将数据存储写入文件
说明
writeall( 将来自输入数据存储 ds,outputLocation)ds 中的数据写入 outputLocation 中指定位置的输出文件。输出文件的数量与数据存储引用的文件数量相同。
writeall( 使用一个或多个名称-值对组参量指定的其他选项写入数据。例如，您可以指定 ds,outputLocation,Name,Value)'OutputFormat' 和文件扩展名（如 'csv'），以指定 writeall 创建的文件的类型。
示例
将一个数据存储写入磁盘，然后为写入的文件创建一个新数据存储。此过程对于保存您的工作或与同事共享数据存储非常有用。
为 airlinesmall.csv 数据集创建一个数据存储，将 'NA' 值视为缺失数据。仅选择 Year、Month 和 Carrier 变量。
ds = datastore('airlinesmall.csv'); ds.TreatAsMissing = 'NA'; ds.SelectedVariableNames = {'Month','Year','UniqueCarrier'};
预览该数据存储。
preview(ds)
ans=8×3 table
Month Year UniqueCarrier
_____ ____ _____________
10 1987 {'PS'}
10 1987 {'PS'}
10 1987 {'PS'}
10 1987 {'PS'}
10 1987 {'PS'}
10 1987 {'PS'}
10 1987 {'PS'}
10 1987 {'PS'}
将此数据存储保存到 C:\ 盘上名为 ExampleData 的新文件夹中。（您可以指定不同的写入位置，特别是当您使用的不是 Windows® 计算机时。）将 'FolderLayout' 指定为 'flatten' 以将数据存储文件直接放入目标文件夹中，而不创建子文件夹。
location = 'C:\ExampleData'; writeall(ds,location,'Folderlayout','flatten')
从您的工作目录中清除 ds。要从磁盘恢复数据存储，请创建一个新数据存储，该数据存储引用写入数据的同一文件夹。
clear ds
ds2 = datastore(location);将数据存储写入文件时，您可以通过设置 'FolderLayout' 参数来选择复制或展平文件夹结构。从输入位置创建一个图像数据存储，然后将该数据存储写入文件。接下来，通过复制文件夹布局在输出位置写入文件。最后，将这些文件作为扁平列表写入输出位置。
从位置 'C:\input\' 创建一个图像数据存储，其中包含一些汽车和火车的图像：
imds = imageDatastore('C:\input\','IncludeSubfolders',true);
此文件夹结构只是一个示例。您可以在包含图像文件的计算机上使用一种文件夹结构来尝试该功能。
检查输入数据存储的 Folders 属性，该属性包含输入数据集的完全限定路径。
imds.Folders
ans =
1×1 cell array
{'C:\input\'}将数据存储写入输出位置 'C:\output\'。'FolderLayout' 参数的默认值为 'duplicate'。因此，writeall 函数会复制输入数据存储的 Folders 属性中包含的所有文件夹，然后将文件写入相应的输出文件夹。
writeall(imds,'C:\output\');
现在，通过将 'FolderLayout' 设置为 'flatten'，将数据存储中的文件作为扁平列表写入输出位置 'C:\output\'。在这种情况下，writeall 函数不会保留输入文件夹布局，而是将所有文件写入一个扁平输出位置。
writeall(imds,'C:\output\','FolderLayout','flatten');
有关详细信息，请参阅 FolderLayout。
您可以使用 FilenamePrefix 和 FilenameSuffix 参数将文本添加到输出文件名的开头或末尾。从输入位置创建一个图像数据存储。将该数据存储写入文件，并在文件名开头追加文本。然后再次写入该数据存储，并在文件名末尾追加文本。
从位置 'C:\input\' 创建一个图像数据存储，其中包含一些汽车和火车的图像：
imds = imageDatastore('C:\input\','IncludeSubfolders',true);
此文件夹结构只是一个示例。您可以在包含图像文件的计算机上使用一种文件夹结构来尝试该功能。
现在，将文件写入一个输出位置。将 FilenamePrefix 的值指定为 'png_'，以将该文本追加到每个输出文件名的开头。
writeall(imds,'C:\output\','FilenamePrefix','png_');
将文件写入一个不同输出位置。将 FilenameSuffix 的值指定为 '_image'，以将该文本追加到每个输出文件名的末尾。
writeall(imds,'C:\output2\','FilenameSuffix','_image');
输入参数
名称-值参数
扩展功能
版本历史记录
在 R2020a 中推出
另请参阅
tabularTextDatastore | imageDatastore | spreadsheetDatastore | parquetDatastore | audioDatastore (Audio Toolbox) | write
