Classe combinable

O objeto combinable<T> destina-se a fornecer cópias de dados privados de thread para executar subcomputações locais de thread sem bloqueio durante algoritmos paralelos. No final da operação paralela, as subcomputações privadas de thread podem ser mescladas em um resultado final. Essa classe pode ser usada em vez de uma variável compartilhada e poderá resultar em uma melhoria de desempenho se, de outra forma, houver muita contenção nessa variável compartilhada.

Sintaxe

template<typename T>
class combinable;

Parâmetros

T
O tipo de dados do resultado final mesclado. O tipo deve ter um construtor de cópia e um construtor padrão.

Membros

Construtores públicos

Nome	Descrição
Combinado	Sobrecarregado. Constrói um novo objeto combinable.
Destruidor ~combinable	Destrói um objeto combinable.

Métodos públicos

Nome	Descrição
clear	Limpa todos os resultados computacionais intermediários de um uso anterior.
combine	Calcula um valor final do conjunto de subcomputações locais de thread chamando o functor de combinação fornecido.
combine_each	Calcula um valor final do conjunto de subcomputações locais de thread chamando o functor de combinação fornecido uma vez para cada subcomputação local de thread. O resultado final é acumulado pelo objeto de função.
local	Sobrecarregado. Retorna uma referência à subcomputação privada de thread.

Operadores públicos

Nome	Descrição
operator=	Atribui a um objeto combinable a partir de outro objeto combinable.

Comentários

Para mais informações, confira Contêineres e objetos paralelos.

Hierarquia de herança

combinable

Requisitos

Cabeçalho: ppl.h

Namespace: concurrency

clear

Limpa todos os resultados computacionais intermediários de um uso anterior.

void clear();

Combinado

Constrói um novo objeto combinable.

combinable();

template <typename _Function>
explicit combinable(_Function _FnInitialize);

combinable(const combinable& _Copy);

Parâmetros

_Function
O tipo do objeto functor de inicialização.

_FnInitialize
Uma função que será chamada para inicializar cada novo valor privado de thread do tipo T. Ele deve dar suporte a um operador de chamada de função com a assinatura T ().

_Copy
Um objeto combinable existente a ser copiado nesse objeto.

Comentários

O primeiro construtor inicializa novos elementos com o construtor padrão para o tipo T.

O segundo construtor inicializa novos elementos usando o functor de inicialização fornecido como o parâmetro _FnInitialize.

O terceiro construtor é o construtor de cópia.

~Combinado

Destrói um objeto combinable.

~combinable();

combine

Calcula um valor final do conjunto de subcomputações locais de thread chamando o functor de combinação fornecido.

template<typename _Function>
T combine(_Function _FnCombine) const;

Parâmetros

_Function
O tipo do objeto de função que será invocado para combinar duas subcomputações locais de thread.

_FnCombine
O functor usado para combinar as subcomputações. Sua assinatura é T (T, T) ou T (const T&, const T&), e deve ser associativa e comutativa.

Valor de Devolução

O resultado final da combinação de todas as subcomputações privadas de thread.

combine_each

Calcula um valor final do conjunto de subcomputações locais de thread chamando o functor de combinação fornecido uma vez para cada subcomputação local de thread. O resultado final é acumulado pelo objeto de função.

template<typename _Function>
void combine_each(_Function _FnCombine) const;

Parâmetros

_Function
O tipo do objeto de função que será invocado para combinar uma única subcomputação local de thread.

_FnCombine
O functor usado para combinar uma subcomputação. Sua assinatura é void (T) ou void (const T&), e deve ser associativa e comutativa.

local

Retorna uma referência à subcomputação privada de thread.

T& local();

T& local(bool& _Exists);

Parâmetros

_Exists
Uma referência a um booliano. O valor booliano referenciado por esse argumento será definido como true se a subcomputação já existir nesse thread, e será definido como false se essa for a primeira subcomputação nesse thread.

Valor de Devolução

Uma referência à subcomputação privada de thread.

operator=

Atribui a um objeto combinable a partir de outro objeto combinable.

combinable& operator= (const combinable& _Copy);

Parâmetros

_Copy
Um objeto combinable existente a ser copiado nesse objeto.

Valor de Devolução

Uma referência a esse objeto combinable.

Confira também

Namespace de simultaneidade