Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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

Fuentes