cancel

バックグラウンドで実行されている関数の停止

構文

cancel(F)

説明

cancel(F) は、Future 配列 F の待機中または実行中の各要素を停止します。

State プロパティが 'finished' でない F の各要素について、cancel は State プロパティを 'finished' に設定します。キャンセルされたすべての Future の要素は、Error プロパティで実行がキャンセルされたことが示されます。

save などの一部の関数と演算は、"Ctrl + C" を押して中断できません。それらの関数を parfeval または parfevalOnAll を使用して実行している場合、cancel でそれらの future を停止できません。delete (Parallel Computing Toolbox) を使用してプールをシャットダウンし、実行中の関数と演算を MATLAB^® で強制的に停止します。

メモ

バックグラウンドプールで delete を使用することは推奨されません。代わりに cancelAll を使用してください。

例

すべて折りたたむ

バックグラウンドで実行されている関数の停止

ライブスクリプトを開く

この例では、バックグラウンドで実行されている MATLAB 関数を停止する方法を示します。parfeval を使用してバックグラウンドで関数を実行すると、MATLAB は即時に Future オブジェクトを返します。長時間実行されている関数が原因で、他の関数をバックグラウンドで実行できなくなることがあります。関数の実行を停止するには、[ライブエディター]、[実行]、[停止] を選択するのではなく、関数 cancel を使用する必要があります。

parfeval を使用して、出力を取得せずに pause(Inf) を実行します。最初の引数として backgroundPool を指定して、関数をバックグラウンドで実行します。parfeval を使用すると、Future オブジェクトが作成されます。

f = parfeval(backgroundPool,@pause,0,Inf);

Future オブジェクトの状態を確認します。

f.State

ans = 
'running'

parfeval を実行すると、関数はバックグラウンドで実行されるようにスケジュールされます。バックグラウンドプールのリソースが関数を実行するには不足している場合、Future は 'queued' 状態になります。関数がバックグラウンドプールで実行されると、Future は 'running' 状態になります。

関数のバックグラウンドでの実行を停止するには、Future オブジェクトをキャンセルします。