KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

std::barrier: herbruikbaar rendez-vous per fase

std::barrier synchroniseert een vaste groep deelnemers aan elke fasegrens en start daarna automatisch de volgende fase.

Versie: 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 uit <barrier> houdt per fase een verwacht aantal aankomsten bij. arrive_and_wait() meldt aankomst en blokkeert, arrive() geeft een token voor later wait(), en arrive_and_drop() verlaagt bovendien blijvend het deelnemersaantal van volgende fasen. std::barrier::arrive_and_wait registreert één aankomst en wacht tot de fase voltooid is. std::barrier::arrive_and_drop registreert een aankomst zonder te wachten en verlaagt het verwachte aantal aankomsten van volgende fasen blijvend met één.

Bij nul wordt de voltooiingsstap normaal precies eenmaal uitgevoerd; als echter geen thread wait aanroept, ook niet via arrive_and_wait, is uitvoering implementatiebepaald. Bij uitvoering worden wachtenden vrijgegeven en wordt de teller voor de volgende fase hersteld. Het einde daarvan strongly happens before de terugkeer van vrijgegeven waits, zodat eerdere writes daarna veilig zichtbaar zijn.

expected moet tussen nul en max() liggen; bij nul kan het object alleen worden vernietigd. Elke deelnemer moet het protocol volgen, anders wachten anderen mogelijk eeuwig. De barrier is niet kopieerbaar en moet alle gebruikers en tokens overleven.

Voorbeelden

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

Resultaat

7

std::barrier → 7

Bronnen