Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::barrier: rendezvous riutilizzabile a fasi

std::barrier sincronizza un gruppo fisso di partecipanti alla fine di ogni fase e avvia automaticamente la successiva.

Versione: C++23

Sintassi

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 di <barrier> mantiene un conteggio degli arrivi attesi per fase. arrive_and_wait() arriva e blocca, arrive() restituisce un token per un successivo wait(), mentre arrive_and_drop() riduce permanentemente i partecipanti delle fasi seguenti. std::barrier::arrive_and_wait registra un arrivo e attende il completamento della fase. std::barrier::arrive_and_drop registra un arrivo senza attendere e riduce permanentemente di uno il conteggio atteso delle fasi successive.

Quando il conteggio arriva a zero, il completamento normalmente viene eseguito una volta; tuttavia, se nessun thread chiama wait, nemmeno tramite arrive_and_wait, l’esecuzione dipende dall’implementazione. Quando avviene, sblocca le attese e reimposta la fase. La sua fine strongly happens before i ritorni sbloccati, quindi le scritture precedenti all’arrivo sono osservabili in sicurezza dopo l’attesa.

expected deve essere tra zero e max(); con zero l’oggetto può soltanto essere distrutto. Ogni partecipante deve rispettare il protocollo, altrimenti altri possono attendere per sempre. La barriera non è copiabile e deve sopravvivere a utenti e token.

Esempi

#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';
}

Risultato

7

std::barrier → 7

Fonti