本页对应的英文页面已更新，但尚未翻译。若要查看最新内容，请点击此处访问英文页面。

readall

读取数据存储中的所有数据

全页折叠

语法

data = readall(ds)

说明

示例

data = readall(ds) 返回 ds 指定的数据存储中的所有数据。

如果数据存储中的数据不能全部载入内存，readall 将返回错误。

示例

全部折叠

读取 TabularTextDatastore 中的所有数据

打开实时脚本

根据示例文件 airlinesmall.csv（包含表格数据）创建一个数据存储。

ds = tabularTextDatastore('airlinesmall.csv','TreatAsMissing','NA',...
    'MissingValue',0);

修改 SelectedVariableNames 属性以指定相关变量。

ds.SelectedVariableNames = {'DepTime','ArrTime','ActualElapsedTime'};

读取数据存储中的所有数据。

T = readall(ds);

readall 返回表中的所有数据。

查看有关表的信息。

T.Properties

ans = 
  TableProperties with properties:

             Description: ''
                UserData: []
          DimensionNames: {'Row'  'Variables'}
           VariableNames: {'DepTime'  'ArrTime'  'ActualElapsedTime'}
    VariableDescriptions: {}
           VariableUnits: {}
      VariableContinuity: []
                RowNames: {}
        CustomProperties: No custom properties are set.
      Use addprop and rmprop to modify CustomProperties.

查看输出表的摘要。

summary(T)

Variables:

    DepTime: 123523x1 double

        Values:

            Min            0  
            Median      1327  
            Max         2505  

    ArrTime: 123523x1 double

        Values:

            Min            0  
            Median      1511  
            Max         2608  

    ActualElapsedTime: 123523x1 double

        Values:

            Min            0  
            Median       100  
            Max         1650

读取 KeyValueDatastore 中的所有数据

打开实时脚本

根据示例文件 mapredout.mat（mapreduce 函数的输出文件）创建一个数据存储。

ds = datastore('mapredout.mat');

读取数据存储中的所有数据。

T = readall(ds);

查看输出表的摘要。

summary(T)

Variables:

    Key: 29x1 cell array of character vectors

    Value: 29x1 cell

读取合并的数据存储中的所有数据

打开实时脚本

创建一个数据存储，用于维护基础数据存储的图像对之间的奇偶校验。例如，创建两个单独的图像数据存储，然后创建一个表示这两个基础数据存储的合并数据存储。

创建一个表示三个图像的集合的图像数据存储 imds1。

imds1 = imageDatastore({'street1.jpg','street2.jpg','peppers.png'});

通过将 imds1 的图像转换为灰度再减小图像大小，创建第二个数据存储 imds2。

imds2 = transform(imds1,@(x) imresize(rgb2gray(x),0.5));

基于 imds1 和 imds2 创建一个合并的数据存储。

imdsCombined = combine(imds1,imds2);

从合并的数据存储中读取所有数据。输出是一个 3×2 元胞数组。两列表示分别从两个基础数据存储 imds1 和 imds2 读取的所有数据。

dataOut = readall(imdsCombined)

dataOut=3×2 cell array
    {480x640x3 uint8}    {240x320 uint8}
    {480x640x3 uint8}    {240x320 uint8}
    {384x512x3 uint8}    {192x256 uint8}

输入参数

全部折叠

`ds` - 输入数据存储
数据存储

输入数据存储。您可以将这些数据存储用作 readall 方法的输入。

MATLAB^® 数据存储 - 使用 MATLAB datastore 函数创建的数据存储。例如，使用 ImageDatastore 为图像集合创建一个数据存储。有关完整的数据存储列表，请参阅Select Datastore for File Format or Application。
合并和转换数据存储 - 使用 combine 和 transform 函数创建的数据存储。
自定义数据存储 - 使用自定义数据存储框架创建的数据存储。请参阅Develop Custom Datastore。

输出参数

全部折叠

`data` - 数据存储中的所有数据
表 | 元胞数组

数据存储中的所有数据，以表或元胞数组形式返回，具体取决于 ds 的类型。

数据存储类型	`data` 的数据类型	说明
`TabularTextDatastore` 和 `SpreadsheetDatastore`	表	`SelectedVariableNames` 属性确定表的变量。
`ImageDatastore`	元胞数组	元胞数组中的每个元素都包含一个图像的图像数据。`readall` 函数支持 `imread` 函数所支持的所有图像类型。有关支持的图像类型的详细信息，请参阅 `imread`。
`KeyValueDatastore`	表	表变量名称是 `Key` 和 `Value`。
`FileDatastore`	元胞数组	元胞数组中的每个元素都包含使用 `ReadFcn` 属性指定的自定义读取函数从一个文件中读取的数据。
`TransformedDatastore`	视情况而定	输出与 `UnderlyingDatastore` 属性指定的基础数据存储所返回的输出相同。例如，如果基础数据存储是一个图像数据存储，则 `data` 以元胞数组形式返回，其中元胞数组中的每个元素都包含一个图像的图像数据。
`CombinedDatastore`	元胞数组	元胞数组的每列都包含对 `UnderlyingDatastores` 属性指定的对应基础数据存储调用 `readall` 所得到的结果。如果基础数据存储中数据子集的数量不同，则 `readall` 仅在所有基础数据存储都有数据时返回数据。例如，假设一个合并的数据存储有两个基础数据存储，一个包含 m 个数据子集，另一个包含 n 个数据子集，其中 m > n。则输出是包含两列和 n 行的元胞数组。