CKTIS / C++
std::barrier: encontro reutilizável por fases
std::barrier sincroniza um grupo fixo de participantes no fim de cada fase e inicia automaticamente a seguinte.
Versão: C++23
Sintaxe
template<class CompletionFunction = /* unspecified */>
class barrier {
public:
explicit barrier(std::ptrdiff_t expected, CompletionFunction completion = CompletionFunction());
void arrive_and_wait();
arrival_token arrive(std::ptrdiff_t update = 1);
void wait(arrival_token&& arrival) const;
void arrive_and_drop();
};std::barrier, de <barrier>, mantém uma contagem de chegadas esperadas por fase. arrive_and_wait() chega e bloqueia, arrive() devolve um token para um wait() posterior e arrive_and_drop() reduz permanentemente os participantes das fases seguintes. std::barrier::arrive_and_wait regista uma chegada e espera pela conclusão da fase. std::barrier::arrive_and_drop regista uma chegada sem esperar e reduz permanentemente em um a contagem esperada das fases seguintes.
Ao chegar a zero, o passo de conclusão normalmente executa exatamente uma vez; contudo, se nenhuma thread chamar wait, incluindo por arrive_and_wait, a execução depende da implementação. Quando executa, desbloqueia esperas e reinicia a contagem da fase seguinte. O seu fim strongly happens before os retornos desbloqueados, logo escritas anteriores à chegada podem ser observadas em segurança depois da espera.
expected tem de ficar entre zero e max(); com zero, o objeto só pode ser destruído. Cada participante deve cumprir o protocolo ou os outros podem esperar para sempre. A barreira não é copiável e deve sobreviver a utilizadores e tokens.
Exemplos
#include <barrier>
#include <iostream>
#include <thread>
int main() {
int value = 0;
std::barrier phase{2};
std::jthread worker([&] {
value = 7;
phase.arrive_and_wait();
});
phase.arrive_and_wait();
std::cout << value << '\n';
}
Resultado
7
std::barrier → 7