Main Content

このページの内容は最新ではありません。最新版の英語を参照するには、ここをクリックします。

parfevalOnAll

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

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

    構文

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

    説明

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

    メモ

    バックグラウンドに複数のワーカーが含まれるのは、Parallel Computing Toolbox™ がある場合のみです。

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

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

    MATLAB は、関数 fcn を各ワーカーで非同期的に [Y1,...,Yn] = fcn(X1,...,Xm) として評価します (m 個の入力と n 個の出力)。

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

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

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

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

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

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

    入力引数

    すべて折りたたむ

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

    例: fcn = @magic

    出力引数の数。非負の整数スカラーとして指定します。

    n は、fcn(X1,...,Xm) の実行で予期される出力引数の数です。

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

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

    出力引数

    すべて折りたたむ

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

    拡張機能

    参考

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

    トピック