task_arena クラス

概要

明示的なユーザー管理タスク・スケジューラー領域の表現。

構文

class task_arena;

ヘッダー

#define TBB_PREVIEW_TASK_ARENA 1
#include “tbb/task_arena.h”

説明

task_arena クラスは、複数のスレッド (スレッド数は最大並列レベルにより制限される) がタスクを共有し実行する、内部タスク・スケジューラー・オブジェクトを表します。

task_arena の並列レベルは分離されており、以前の task_scheduler_init 仕様の影響を受けません。

task_arena オブジェクトは、内部表現への参照を保持しますが、その生存期間は完全に管理しません。 タスクが含まれるか、ほかのワーカースレッドが参照するまで破棄できません。

task_scheduler_init オブジェクトを明示的または暗黙的に作成する各ユーザースレッドには、暗黙の内部タスク領域オブジェクトが含まれます。 タスク領域にスポーンまたは追加されたタスクは、ほかのタスク領域では実行できません。

このプレビュー機能を使用するには、コミュニティー・プレビュー・ライブラリーとリンクする必要があります。

メンバー

namespace tbb {
class task_arena {
public:
    static const int automatic = implementation-defined;
    static int current_slot();
    task_arena(int max_concurrency = automatic);
    task_arena(const task_arena &s);
    ~task_arena();
    void initialize(int max_concurrency);
    template<typename F> void enqueue( const F& f );
#if __TBB_TASK_PRIORITY // TODO: remove???
    template<typename F> void enqueue( const F& f, priority_t p );
#endif
    template<typename F> void execute(F& f);
    template<typename F> void execute(const F& f); // TODO:remove?
    void wait_until_empty();
};
}

例

次の例は、同時に 2 つの paralel_for ループを実行します。1 つはスケーラブルで、もう 1 つはスケーラブルではありません。 スケーラブルでないループは最大 2 スレッドに制限されるため、ほとんどのスレッドはスケーラブルなループに使用できます。

tbb::task_scheduler_init def_init; // スレッドのデフォルトの番号を使用
tbb::task_arena limited(2);// この領域では最大 2 スレッドのみ

limited.enqueue([]{ // 最大 2 つのスレッドを使用
    tbb::parallel_for(1, N, unscalable_work());
}); 

// 別のジョブを上記のループと並列に実行
// スレッドのデフォルトの番号を使用可能:
tbb::parallel_for(1, M, scalable_work());

limited.wait_until_empty(); // 同期作業が終了することを保証

上記の例は、最後の行で wait_until_empty() を呼び出し、タスク領域のすべての作業が完了するのを待機します。 特定のタスクのサブセットの完了を待機する必要がある場合は、次のように task_group を使用できます。

tbb::task_arena arena;
tbb::task_group tg;

// タスクグループの作業をキューに入れる
for( int i=0; i<N; ++i)
    arena.enqueue([&,=i] { tg.run( F(i) ) });

// ほかの作業を行う ...

// execute() の内側でタスクグループを
// 待つようにする
// この arena のタスクのみを待つ
arena.execute([&]{ tg.wait(); });