task_group_context クラス

概要

キャンセル可能なタスクのグループ。

構文

class task_group_context;

ヘッダー

#include "tbb/task.h"

説明

task_group_context は、キャンセル可能な、または優先度レベルが設定された、タスクのグループを表します。すべてのタスクはグループに属します。タスクは 1 つのグループのメンバーになることができます。

ルートタスクは、task::allocate_root() 呼び出しの task_group_context オブジェクトで渡されるグループと関連しています。子タスクは、親タスクのグループに自動的に属します。タスクは、task::change_group() メソッドを使用してほかのグループに移動できます。

task_group_context オブジェクトはツリー形式です。各ツリーのルートは、task_group_context で isolated として構築されます。

task_group_context は、リクエストにより明示的に、または例外がタスクからスローされたときに暗黙的にキャンセルされます。task_group_context をキャンセルすると、そのルート以下のツリー全体がキャンセルされます。

グループのすべてのタスクの優先度は、関連付けられている task_group_context オブジェクトから、またはグループに属するすべてのタスクから、いつでも変更できます。キャンセルと同様に、優先度を変更すると、グループの子タスクの優先度も変更されます。タスク実行に対する優先度の影響は、「優先度」セクションで説明されています。

task_scheduler_init を暗黙的に作成する各ユーザースレッドには、初期ツリーのルートの役割をする isolated task_group_context が含まれます。ユーザースレッドがタスクを実行していない場合、このコンテキストは task::self() によって返されるダミータスクと関連しています。

メンバー

namespace tbb {
    class task_group_context {
    public:
        enum kind_t {
            isolated = implementation-defined,
            bound = implementation-defined
        };

        enum traits_type {
            exact_exception = implementation-defined,
            fp_settings     = implementation-defined,
            concurrent_wait = implementation-defined,
#if TBB_USE_CAPTURED_EXCEPTION
            default_traits = 0
#else
            default_traits = exact_exception
#endif /* !TBB_USE_CAPTURED_EXCEPTION */
        };
        task_group_context( kind_t relation_with_parent = bound, 
                            uintptr_t traits = default_traits );
        ~task_group_context();
        void reset();
        bool cancel_group_execution();
        bool is_group_execution_cancelled() const;
        void capture_fp_settings();
        void set_priority( priority_t );
        priority_t priority() const;
        uintptr_t traits() const;
    }; 
}