reset

データストアの初期状態へのリセット

構文

reset(ds)

説明

reset(ds) は、ds で指定されたデータストアをデータの読み取り前の状態にリセットします。リセットすると、同じデータストアからの読み取りを再度実行できます。

例

データストアの初期状態へのリセット

関数 mapreduce の出力ファイルであるサンプル ファイル mapredout.mat からデータストアを作成します。

ds = datastore('mapredout.mat');

最初のキーと値のペアを読み取ります。

T = read(ds);

データストアをデータの読み取り前の状態にリセットします。

reset(ds)

入力引数

ds — 入力データストア

データストア

入力データストア。次のデータストアを reset メソッドの入力として使用できます。

• MATLAB^® データストア — MATLAB datastore 関数を使用して作成されたデータストア。たとえば、ImageDatastore を使用して、イメージの集合用のデータストアを作成します。データストアの完全な一覧については、ファイル形式またはアプリケーション用のデータストアの選択を参照してください。

• 統合または変換を行ったデータストア — 関数 combine および transform を使用して作成したデータストア。

• カスタム データストア — カスタム データストア フレームワークを使用して作成したデータストア。カスタム データストアの開発を参照してください。

拡張機能

スレッドベースの環境

MATLAB® の backgroundPool を使用してバックグラウンドでコードを実行するか、Parallel Computing Toolbox™ の ThreadPool を使用してコードを高速化します。

使用上の注意および制限:

• スレッドベースの環境では、次のデータストアでのみ reset を使用できます。

  • ImageDatastore オブジェクト

  • combine または transform を使用して ImageDatastore オブジェクトから作成する CombinedDatastore、SequentialDatastore、または TransformedDatastore オブジェクト

  Parallel Computing Toolbox™ がある場合は、他のデータストアで reset を使用できます。これを行うには、backgroundPool または ThreadPool を使用する代わりに、プロセスベースの並列プールを使用して関数を実行します (ProcessPool または ClusterPool を使用します)。

詳細については、スレッドベースの環境での MATLAB 関数の実行を参照してください。

バージョン履歴

R2014b で導入

参考

datastore