Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / C++

std::barrier: višekratno fazno okupljanje

std::barrier sinkronizira stalnu skupinu sudionika na kraju svake faze i automatski pokreće sljedeću.

Verzija: C++23

Sintaksa

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 iz <barrier> za svaku fazu vodi očekivani broj dolazaka. arrive_and_wait() dolazi i čeka, arrive() vraća token za kasniji wait(), a arrive_and_drop() trajno smanjuje broj sudionika sljedećih faza. std::barrier::arrive_and_wait bilježi jedan dolazak i čeka dovršetak faze. std::barrier::arrive_and_drop bilježi dolazak bez čekanja i trajno smanjuje očekivani broj dolazaka sljedećih faza za jedan.

Kad broj dosegne nulu, završni korak obično se izvodi točno jednom; ako nijedna dretva ne pozove wait, ni kroz arrive_and_wait, hoće li se izvesti ovisi o implementaciji. Kad se izvede, odblokira čekanja i vraća brojač za novu fazu. Njegov kraj strongly happens before povratke odblokiranih čekanja, pa su raniji zapisi nakon toga sigurno vidljivi.

expected mora biti između nule i max(); uz nulu objekt se može samo uništiti. Svaki sudionik mora poštovati protokol ili drugi mogu čekati zauvijek. Barijera se ne kopira i mora nadživjeti korisnike i tokene.

Primjeri

#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';
}

Rezultat

7

std::barrier → 7

Izvori