reset

Reset datastore to initial state

Syntax

reset(ds)

Description

reset(ds)resets the datastore specified bydsto the state where no data has been read from it. Resetting allows re-reading from the same datastore.

Examples

collapse all

Reset Datastore to Initial State

Open Live Script

Create a datastore from the sample file,mapredout.mat, which is the output file of themapreducefunction.

ds = datastore('mapredout.mat');

Read the first key-value pair.

T = read(ds);

Reset the datastore to the state where no data has been read from it.

reset(ds)

Input Arguments

collapse all

`ds`—Input datastore
datastore

Input datastore. You can use these datastores as input to theresetmethod.

MATLAB^®datastores — Datastores created using MATLABdatastorefunctions. For example, create a datastore for a collection of images usingImageDatastore. For a complete list of datastores, seeSelect Datastore for File Format or Application.
Combined or transformed datastores — Datastores created using thecombineandtransformfunctions.
Custom datastores — Datastores created using the custom datastore framework. SeeDevelop Custom Datastore.

Extended Capabilities

Thread-Based Environment
Run code in the background using MATLAB®`backgroundPool`or accelerate code with Parallel Computing Toolbox™`ThreadPool`.

Usage notes and limitations:

In a thread-based environment, you can useresetonly with the following datastores:
- ImageDatastoreobjects
- CombinedDatastoreorTransformedDatastoreobjects you create fromImageDatastoreobjects by usingcombineortransform
You can useresetwith other datastores if you have Parallel Computing Toolbox™. To do so, run the function using a process-backed parallel pool instead of usingbackgroundPoolorThreadPool(use eitherProcessPoolorClusterPool).

For more information, seeRun MATLAB Functions in Thread-Based Environment.

Version History

Introduced in R2014b