Classe de task_group

Artigo
08/01/2011

O task_group classe representa uma coleção de trabalho paralelos que pode ser aguardado ou cancelada.

class task_group;

Membros

Construtores públicos

Nome	Descrição
Construtor de task_group::task_group	Constrói uma nova task_group objeto.
task_group:: ~ task_group destruidor	Destrói um task_group objeto. Espera-se que você chamar uma a wait ou run_and_wait desenrolar do método no objeto antes para o destruidor execução, a menos que o destruidor está sendo executado como resultado de pilha devido a uma exceção.

Métodos públicos

Nome	Descrição
Método de task_group::Cancel	Faz um melhor esforço tentar cancelar a subárvore com raiz neste grupo de tarefas de trabalho. Todas as tarefas agendadas em um grupo de tarefas serão obter cancelada transitivamente se possível.
Método de task_group::is_canceling	Informa o chamador ou não o grupo de tarefas está no meio de um cancelamento. Isso não indica necessariamente que o cancel método foi chamado a task_group objeto (embora, certamente qualifica este método para retornar true). Ele pode ser o caso que a task_group objeto está em execução in-line e um grupo de tarefas ainda mais para cima na árvore de trabalho foi cancelado. Em casos como esses onde o runtime pode determinar antecipadamente cancelamento irá fluir por isso task_group o objeto, true será retornado como bem.
Método de task_group::Run	Sobrecarregado. Agenda uma tarefa sobre o task_group objeto. Se um task_handle objeto é passado como um parâmetro para run, o chamador é responsável por gerenciar a vida útil do task_handle objeto. A versão do método que leva uma referência a um objeto de função como um parâmetro envolve a alocação de heap dentro do tempo de execução que pode ser executar menos bem que usar a versão que pega uma referência a um task_handle objeto.
Método de task_group::run_and_wait	Sobrecarregado. Agenda uma tarefa para ser executado embutido no contexto de chamada com o auxílio do task_group o objeto para o suporte a cancelamento completo. A função espera até que todos funcionam na task_group objeto concluída ou cancelado. Se um task_handle objeto é passado como um parâmetro para run_and_wait, o chamador é responsável por gerenciar a vida útil do task_handle objeto.
Método de task_group::wait	Aguarda até que todos funcionam na task_group objeto concluída ou cancelado.

Comentários

Ao contrário do altamente restrita structured_task_group classe, o task_group classe é muito mais geral de construção. Não tem qualquer uma das restrições descritas por structured_task_group. task_groupobjetos com segurança podem ser usados pelos threads e utilizados de formas de forma livre. A desvantagem do task_group construção é que ele não pode executar, bem como a structured_task_group Construir para tarefas que executa pequenas quantidades de trabalho.

Para obter mais informações, consulte Paralelismo de tarefas (Runtime de simultaneidade).