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