Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C++

std::barrier : rendez-vous réutilisable par phases

std::barrier synchronise un groupe fixe de participants à chaque fin de phase puis commence automatiquement la suivante.

Version : 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 de <barrier> maintient un nombre d’arrivées attendu pour chaque phase. arrive_and_wait() arrive puis bloque, arrive() renvoie un jeton destiné à un wait() ultérieur, et arrive_and_drop() réduit aussi définitivement le nombre des phases suivantes. std::barrier::arrive_and_wait enregistre une arrivée puis attend la fin de la phase. std::barrier::arrive_and_drop enregistre une arrivée sans attendre et réduit définitivement d’une unité le nombre d’arrivées attendu des phases suivantes.

Quand le compteur atteint zéro, l’étape d’achèvement s’exécute normalement exactement une fois ; toutefois, si aucun thread n’appelle wait, y compris via arrive_and_wait, son exécution dépend de l’implémentation. Si elle a lieu, les attentes sont libérées et le compteur est réinitialisé. La fin de l’achèvement strongly happens before le retour des attentes libérées : les écritures antérieures à l’arrivée sont alors observables sans danger.

expected doit être compris entre zéro et max() ; avec zéro, l’objet ne peut qu’être détruit. Chaque participant doit respecter le protocole sous peine d’attente infinie. La barrière n’est pas copiable et doit survivre à tous ses utilisateurs et jetons.

Exemples

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

Résultat

7

std::barrier → 7

Sources