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,
                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 set_priority ( priority_t );
            priority_t priority () const;
        };  
    }