帮助中心帮助中心

reset

将数据存储重置为初始状态

语法

reset(ds)

说明

reset(ds) 将 ds 指定的数据存储重置为尚未从其中读取任何数据的状态。重新设置可以从同一数据存储重新读取。

示例

将数据存储重置为初始状态

打开实时脚本

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

ds = datastore('mapredout.mat');

读取第一个键-值对组。

T = read(ds);

将数据存储重置为尚未从其中读取任何数据的状态。

reset(ds)

输入参数

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

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

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

扩展功能

基于线程的环境
使用 MATLAB® `backgroundPool` 在后台运行代码或使用 Parallel Computing Toolbox™ `ThreadPool` 加快代码运行速度。

用法说明和限制：

在基于线程的环境中，您只能对以下数据存储使用 reset：
- ImageDatastore 对象
- 使用 combine 或 transform 从 ImageDatastore 对象创建的 CombinedDatastore、SequentialDatastore 或 TransformedDatastore 对象
如果您有 Parallel Computing Toolbox™，则可以对其他数据存储使用 reset。为此，请使用基于进程的并行池运行该函数，而不是使用 backgroundPool 或 ThreadPool（使用 ProcessPool 或 ClusterPool）。

有关详细信息，请参阅Run MATLAB Functions in Thread-Based Environment。

版本历史记录

在 R2014b 中推出

另请参阅