CKTIS / C++
std::barrier: opakovane použiteľné stretnutie fáz
std::barrier synchronizuje pevnú skupinu účastníkov na konci každej fázy a automaticky spustí ďalšiu.
Verzia: 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 z <barrier> udržiava počet očakávaných príchodov v každej fáze. arrive_and_wait() príde a čaká, arrive() vráti token pre neskoršie wait() a arrive_and_drop() navyše trvalo zníži počet účastníkov ďalších fáz. std::barrier::arrive_and_wait zaznamená jeden príchod a čaká na dokončenie fázy. std::barrier::arrive_and_drop zaznamená príchod bez čakania a trvalo zníži očakávaný počet príchodov ďalších fáz o jeden.
Pri dosiahnutí nuly sa krok dokončenia zvyčajne vykoná práve raz; ak však žiadne vlákno nezavolá wait, ani cez arrive_and_wait, jeho vykonanie závisí od implementácie. Keď prebehne, odblokuje čakajúcich a obnoví počítadlo ďalšej fázy. Jeho koniec strongly happens before návraty odblokovaných čakaní, takže zápisy pred príchodom možno potom bezpečne pozorovať.
expected musí byť od nuly do max(); pri nule možno objekt len zničiť. Každý účastník musí dodržať protokol, inak ostatní môžu čakať navždy. Bariéra nie je kopírovateľná a musí prežiť používateľov a tokeny.
Prí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ýsledok
7
std::barrier → 7