Main Content

parfevalOnAll

すべてのワーカーでバックグラウンドで関数を実行

ページ内をすべて折りたたむ

    構文

    F = parfevalOnAll(backgroundPool,fcn,numFcnOut,X1,...,Xm)
    F = parfevalOnAll(fcn,numFcnOut,X1,...,Xm)

    説明

    F = parfevalOnAll(backgroundPool,fcn,numFcnOut,X1,...,Xm) は、関数 fcn をすべてのワーカーでバックグラウンドで実行するようにスケジュールします。MATLAB® が関数 fcn を実行している間、他のコードを実行できます。ワーカーおよびバックグラウンドの詳細については、バックグラウンド ワーカーを参照してください。

    メモ

    backgroundPool に複数のワーカーが含まれるのは、Parallel Computing Toolbox™ がある場合のみです。

    backgroundPool を使用してバックグラウンドでコードを実行する場合、parfevalOnAll を使用して環境変数を設定する必要はありません。

    並列プールのすべてのワーカーで関数を実行する場合は、parfevalOnAll (Parallel Computing Toolbox) を参照してください。

    MATLAB は、関数 fcn を入力引数 X1,X2,…,Xm を使用して各ワーカーで非同期的に評価し、numFcnOut 個の出力引数を返します。

    MATLAB は、すべてのバックグラウンド ワーカーでの関数 fcn の実行が完了する前に Future オブジェクト F を返します。fetchOutputs を使用して future から結果を取得できます。関数 fcn の実行を停止するには、関数 cancel を使用します。future の詳細については、Future を参照してください。

    F = parfevalOnAll(fcn,numFcnOut,X1,...,Xm) は関数 fcn の実行をスケジュールします。

    MATLAB は、関数 fcn の実行が完了する前に Future オブジェクト F を返します。

    この構文は、Parallel Computing Toolbox で使用するために設計されたコードで使用します。

    • Parallel Computing Toolbox がない場合、並列リソースを使用しません。関数は逐次実行されます。

    • Parallel Computing Toolbox がある場合、parfevalOnAll は並列リソースを自動的に使用します。

    入力引数

    すべて折りたたむ

    実行対象の関数。関数ハンドルとして指定します。

    例: fcn = @magic

    関数 fcn から要求する出力引数の数。非負の整数スカラーとして指定します。

    numFcnOut は、fcn(X1,...,Xm) の実行時に要求する出力引数の数です。

    データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

    入力引数。変数または式のコンマ区切りリストとして指定します。

    出力引数

    すべて折りたたむ

    出力 Future。parallel.Future オブジェクトとして返されます。

    拡張機能

    参考

    (Parallel Computing Toolbox) | | | | | | |

    トピック