CKTIS / C++
std::barrier: opakovaně použitelné setkání fází
std::barrier synchronizuje pevnou skupinu účastníků na konci každé fáze a automaticky spustí další.
Verze: C++23
Syntaxe
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 z <barrier> udržuje počet očekávaných příchodů v každé fázi. arrive_and_wait() přijde a čeká, arrive() vrátí token pro pozdější wait() a arrive_and_drop() navíc trvale sníží počet účastníků dalších fází. std::barrier::arrive_and_wait zaznamená jeden příchod a čeká na dokončení fáze. std::barrier::arrive_and_drop zaznamená příchod bez čekání a trvale sníží očekávaný počet příchodů dalších fází o jeden.
Při dosažení nuly se krok dokončení obvykle provede právě jednou; pokud však žádné vlákno nezavolá wait, ani přes arrive_and_wait, je jeho provedení závislé na implementaci. Když proběhne, odblokuje čekající a obnoví čítač další fáze. Jeho konec strongly happens before návraty odblokovaných čekání, takže zápisy před příchodem lze poté bezpečně pozorovat.
expected musí být od nuly do max(); při nule lze objekt jen zničit. Každý účastník musí dodržet protokol, jinak ostatní mohou čekat navždy. Bariéra není kopírovatelná a musí přežít všechny uživatele a tokeny.
Příklady
#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';
}
Výsledek
7
std::barrier → 7