Compartilhar via


classe de task_group

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

class task_group;

Membros

Dd470722.collapse_all(pt-br,VS.110).gifConstrutores públicos

Nome

Descrição

Construtor de task_group::task_group

Sobrecarregado.Constrói um novo task_group objeto.

task_group:: ~ task_group destruidor

Destrói um task_group objeto.Você deve chamar à wait ou run_and_wait método no objeto antes para o destruidor execução, a menos que o destruidor é executado como resultado de pilha desenrolar devido a uma exceção.

Dd470722.collapse_all(pt-br,VS.110).gifMétodos públicos

Nome

Descrição

método de task_group::cancel

Faz o melhor esforço tentar cancelar a subárvore com raiz neste grupo de tarefas de trabalho.Cada tarefa agendada no grupo de tarefas será obter cancelada transitivamente se possível.

método task_group::is_canceling

Informa ao chamador ou não o grupo de tarefas está atualmente no meio de um cancelamento.Isso não indica necessariamente que o cancel método foi chamado de task_group objeto (embora, certamente qualifica esse método para retornar true).Ele pode ser o caso que a task_group objeto 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 objeto, true também será retornado.

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 usa uma referência a um objeto de função como um parâmetro envolve alocação de heap dentro do tempo de execução que pode ser executar menos bem que usar a versão que leva uma referência a um task_handle objeto.A versão que aceita o parâmetro _Placement faz com que a tarefa a ser viesado para executar no local especificado por esse parâmetro.

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 objeto para suporte ao cancelamento completo.A função aguarda até que todos funcionem 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 funcionem na task_group objeto concluída ou cancelado.

Comentários

Ao contrário muito restritos structured_task_group classe, o task_group classe é construção muito mais geral.Não tem qualquer as restrições descritas por structured_task_group.task_groupobjetos com segurança podem ser usados em threads e utilizados de formas livres.A desvantagem do task_group construção é que ele não pode realizar bem como o structured_task_group construir para tarefas que realizar pequenas quantidades de trabalho.

Para mais informações, consulte Paralelismo de tarefa (tempo de execução de simultaneidade).

Hierarquia de herança

task_group

Requisitos

Cabeçalho: ppl.h

Namespace: concorrência

Consulte também

Referência

simultaneidade Namespace

classe de structured_task_group

classe de task_handle