Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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

Fontes