CKTIS / C++
std::barrier: encuentro reutilizable por fases
std::barrier sincroniza un grupo fijo de participantes al final de cada fase y comienza automáticamente la siguiente.
Versión: C++23
Sintaxis
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>, mantiene una cuenta de llegadas esperadas por fase. arrive_and_wait() llega y bloquea, arrive() devuelve un token para un wait() posterior y arrive_and_drop() también reduce permanentemente los participantes de fases siguientes. std::barrier::arrive_and_wait registra una llegada y espera a que termine la fase. std::barrier::arrive_and_drop registra una llegada sin esperar y reduce permanentemente en uno la cuenta esperada de las fases posteriores.
Al llegar la cuenta a cero, el paso de finalización normalmente se ejecuta una vez; sin embargo, si ningún hilo llama a wait, tampoco mediante arrive_and_wait, que se ejecute depende de la implementación. Cuando se ejecuta, desbloquea a quienes esperan y reinicia la cuenta. Su final strongly happens before los retornos desbloqueados, por lo que las escrituras anteriores a la llegada se pueden observar con seguridad después de esperar.
expected debe estar entre cero y max(); con cero solo se puede destruir el objeto. Cada participante debe respetar el protocolo o los demás pueden esperar para siempre. La barrera no es copiable y debe sobrevivir a usuarios y tokens.
Ejemplos
#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