task_scheduler_init クラス

概要

タスク・スケジュール・サービスにおけるスレッドの状態を明示的に表すクラス。

構文

class task_scheduler_init;

ヘッダー

#include "tbb/task_scheduler_init.h"

説明

task_scheduler_init の使用は、インテル® TBB 2.2 ではオプションです。デフォルトでは、インテル® TBB 2.2 は、スレッドが最初にタスク・スケジュール・サービスを使用するときにタスク・スケジューラーを自動的に作成し、スレッドが最後に終了するときにタスク・スケジューラーを破棄します。

task_scheduler_init のインスタンスは、次のような場合に使用できます。

タスク・スケジュールのデフォルトの動作をオーバーライドするには、タスク・スケジュール・サービスを最初に使用する前に task_scheduler_init がアクティブになっていなければなりません。

task_scheduler_init は、"アクティブ" または "インアクティブ" のいずれかです。

task_scheduler_init のデフォルト・コンストラクターはオブジェクトをアクティブにし、デストラクターはオブジェクトを非アクティブにします。初期化を遅らせるには、コンストラクターに task_scheduler_init::deferred 値を渡します。この場合、task_scheduler_initinitialize メソッドを呼び出して、後で初期化されます。初期化された task_scheduler_init の破棄は、オブジェクトを暗黙的に非アクティブにします。オブジェクトをより早く非アクティブにするには、terminate メソッドを呼び出します。

コンストラクターのオプション引数および initialize メソッドでタスク実行に使用されるスレッド数を指定できます。この引数は開発中にスケーリングを調査するのに役立ちますが、製品には設定しないでください。

ヒント

製品コードでスレッド数を指定しない理由は、大規模なソフトウェア・プロジェクトでは、さまざまなコンポーネントでほかのスレッドに対する最適なスレッド数を知る方法がないためです。ハードウェア・スレッドは、共有グローバルリソースであるため、タスク・スケジューラーにスレッド数の制御を任せるのが最良の方法です。

タスク・スケジューラーは、初期化中に現在のスレッドから浮動小数点設定を取得します。取得した浮動小数点設定は、すべてのワーカースレッドに伝えられます。詳細は、「浮動小数点設定」セクションを参照してください。

時間のオーバーヘッドを最小限にするには、スレッドがすべてのライブラリーのタスク・スケジュールをアクティブ化して使用する間は単一の task_scheduler_init オブジェクトを作成することがベストです。task_scheduler_init は、コピー構築や割り当てはできません。

サンプル

// Sketch of one way to do a scaling study
#include <iostream>
#include "tbb/task_scheduler_init.h"
#include "tbb/tick_count.h"

int main() {
    int n = tbb::task_scheduler_init::default_num_threads();
    for (int p = 1; p <= n; ++p) {
        // Construct task scheduler with p threads
        tbb::task_scheduler_init init(p);
        tbb::tick_count t0 = tbb::tick_count::now();
        // Execute parallel algorithm using task or
        // template algorithm here
        tbb::tick_count t1 = tbb::tick_count::now();
        double t = (t1 - t0).seconds();
        std::cout << "time = " << t << " with " << p << " threads" << std::endl;
        // Implicitly destroy task scheduler
    }
    return 0;
}

メンバー

  namespace tbb {
        typedef unsigned-integral-type stack_size_type;
     
        class task_scheduler_init {
        public:
            static const int automatic = implementation-defined;
            static const int deferred = implementation-defined;
            task_scheduler_init( int max_threads=automatic, 
                                 stack_size_type thread_stack_size=0 );
            ~task_scheduler_init();
            void initialize( int max_threads=automatic );
            void terminate();
            static int default_num_threads();
            bool is_active() const;
        };
    } // tbb 名前空間