fetchNext
Future
配列から次の未読の出力を取得
説明
[
は、配列 idx
,Y1,...,Ym
] = fetchNext(F
)F
内の終了済みで未読の次の FevalFuture
オブジェクトの線形インデックス idx
を取得し、その Future
からの m
個の結果を Y1,...,Ym
として取得します。
fetchNext
は、parfeval
を使用して作成した FevalFuture
オブジェクトでのみ使用できます。
FevalFuture
が未読となるのは、そのRead
プロパティがfalse
の場合です。F
に未読の要素がない場合、MATLAB® はエラーをスローします。FevalFuture
が終了済みとなるのは、そのState
プロパティが'finished'
の場合です。'finished'
状態である未読の要素がない場合、MATLAB はまずF
の要素が終了するまで待機します。
fetchNext
は、F
から完了順に要素を読み取ります。fetchNext
が配列 F
内の次の未読の Future
オブジェクトからの出力を取得すると、MATLAB はその FevalFuture
の Read
プロパティを true
に設定します。
関数 fetchNext
は、F
からの要素の読み取りでエラーが発生した場合、まず Future
の要素の Read
プロパティを true に設定します。その後、fetchNext
はエラーをスローします。
例
入力引数
出力引数
バージョン履歴
R2013b で導入