Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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

Zdroje