CKTIS / C++
std::barrier: wielofazowe spotkanie wątków
std::barrier synchronizuje stałą grupę uczestników na końcu każdej fazy i automatycznie rozpoczyna następną.
Wersja: C++23
Składnia
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> ma licznik oczekiwanych przybyć dla każdej fazy. arrive_and_wait() zgłasza przybycie i czeka, arrive() zwraca token do późniejszego wait(), a arrive_and_drop() także trwale zmniejsza liczbę uczestników następnych faz. std::barrier::arrive_and_wait zgłasza jedno przybycie i czeka na zakończenie fazy. std::barrier::arrive_and_drop zgłasza przybycie bez czekania oraz trwale zmniejsza o jeden oczekiwaną liczbę przybyć w kolejnych fazach.
Gdy licznik osiąga zero, krok zakończenia zwykle wykonuje się dokładnie raz; jeżeli jednak żaden wątek nie wywołuje wait (także poprzez arrive_and_wait), standard pozostawia implementacji decyzję, czy krok zostanie wykonany. Po wykonaniu odblokowywani są czekający i licznik resetuje się dla kolejnej fazy. Koniec kroku zakończenia strongly happens before powroty odblokowanych wywołań, więc zapisy uczestników sprzed przybycia mogą być bezpiecznie obserwowane po oczekiwaniu.
Argument expected musi mieścić się od zera do max(); dla zera obiekt można tylko zniszczyć. Każdy uczestnik musi przestrzegać liczby przybyć, inaczej inni mogą czekać bez końca. Bariera nie jest kopiowalna i musi żyć, dopóki dowolny wątek może używać jej lub tokenu przybycia.
Przykłady
#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';
}
Wynik
7
std::barrier → 7