CKTIS / C++
std::barrier: wiederverwendbarer Phasentreffpunkt
std::barrier synchronisiert eine feste Teilnehmergruppe an jeder Phasengrenze und startet danach automatisch die nächste Phase.
Version: C++23
Syntax
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 aus <barrier> verwaltet pro Phase eine erwartete Ankunftszahl. arrive_and_wait() meldet Ankunft und wartet, arrive() liefert ein Token für ein späteres wait(), und arrive_and_drop() verkleinert zusätzlich dauerhaft die Teilnehmerzahl folgender Phasen. std::barrier::arrive_and_wait meldet eine Ankunft und wartet auf den Phasenabschluss. std::barrier::arrive_and_drop meldet eine Ankunft ohne Warten und senkt die erwartete Ankunftszahl folgender Phasen dauerhaft um eins.
Erreicht der Zähler null, läuft der Abschluss normalerweise genau einmal; ruft jedoch kein Thread wait auf, auch nicht über arrive_and_wait, ist die Ausführung implementierungsdefiniert. Wird er ausgeführt, werden Wartende freigegeben und der Zähler für die nächste Phase zurückgesetzt. Das Ende des Abschlusses happens strongly before den Rückgaben der freigegebenen Warteaufrufe; Schreibzugriffe vor der Ankunft sind danach sicher beobachtbar.
expected muss zwischen null und max() liegen; bei null darf das Objekt nur zerstört werden. Alle Teilnehmer müssen das Protokoll einhalten, sonst können andere ewig warten. Die Barriere ist nicht kopierbar und muss alle Benutzer und Ankunftstoken überleben.
Beispiele
#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';
}
Ergebnis
7
std::barrier → 7