CKTIS / C++
std::barrier: ponovno uporabno srečanje faz
std::barrier sinhronizira stalno skupino udeležencev na koncu vsake faze in samodejno začne naslednjo.
Različica: C++23
Sintaksa
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 iz <barrier> za vsako fazo hrani pričakovano število prihodov. arrive_and_wait() prispe in čaka, arrive() vrne žeton za poznejši wait(), arrive_and_drop() pa trajno zmanjša število udeležencev naslednjih faz. std::barrier::arrive_and_wait zabeleži en prihod in počaka na konec faze. std::barrier::arrive_and_drop zabeleži prihod brez čakanja in trajno zmanjša pričakovano število prihodov naslednjih faz za ena.
Ko števec doseže nič, se zaključek običajno izvede natanko enkrat; če pa nobena nit ne pokliče wait, niti prek arrive_and_wait, je izvedba odvisna od implementacije. Ko se izvede, sprosti čakajoče in ponastavi naslednjo fazo. Njegov konec strongly happens before vrnitve sproščenih čakanj, zato so prejšnji zapisi nato varno vidni.
expected mora biti med nič in max(); pri nič lahko objekt le uničimo. Vsak udeleženec mora spoštovati protokol, sicer drugi lahko čakajo večno. Pregrada ni kopirljiva in mora preživeti vse uporabnike in žetone.
Primeri
#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';
}
Rezultat
7
std::barrier → 7