classe de task_group

Artigo
02/25/2013

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	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.

Mé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).