Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C++

std::barrier: opakovaně použitelné setkání fází

std::barrier synchronizuje pevnou skupinu účastníků na konci každé fáze a automaticky spustí další.

Verze: C++23

Syntaxe

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žuje počet očekávaných příchodů v každé fázi. arrive_and_wait() přijde a čeká, arrive() vrátí token pro pozdější wait() a arrive_and_drop() navíc trvale sníží počet účastníků dalších fází. std::barrier::arrive_and_wait zaznamená jeden příchod a čeká na dokončení fáze. std::barrier::arrive_and_drop zaznamená příchod bez čekání a trvale sníží očekávaný počet příchodů dalších fází o jeden.

Při dosažení nuly se krok dokončení obvykle provede právě jednou; pokud však žádné vlákno nezavolá wait, ani přes arrive_and_wait, je jeho provedení závislé na implementaci. Když proběhne, odblokuje čekající a obnoví čítač další fáze. Jeho konec strongly happens before návraty odblokovaných čekání, takže zápisy před příchodem lze poté bezpečně pozorovat.

expected musí být od nuly do max(); při nule lze objekt jen zničit. Každý účastník musí dodržet protokol, jinak ostatní mohou čekat navždy. Bariéra není kopírovatelná a musí přežít všechny uživatele a tokeny.

Pří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ýsledek

7

std::barrier → 7

Zdroje