WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::latch — einmaliges Warten, bis ein Zähler null erreicht

std::latch aus <latch> ermöglicht es Threads, darauf zu warten, dass ein Zähler null erreicht. count_down() meldet den Abschluss eines Arbeitsschritts; wait() wartet auf das Ende des Countdowns, ohne den Zähler zu verändern.

Version: C++23; repository compiler flag, production runtime not attested

Syntax

#include <latch>
std::latch done{expected};
done.count_down();
done.wait();

std::latch ist ein einmalig verwendbarer Synchronisationsmechanismus aus <latch>. Sein Konstruktor setzt den Zähler auf expected, wobei 0 <= expected && expected <= std::latch::max() gelten muss. Der Zähler steht für noch ausstehende Meldungen, nicht unbedingt für verschiedene Threads. Sobald er null erreicht, kann das Objekt weder zurückgesetzt noch für eine weitere Runde verwendet werden.

std::latch::count_down(update) zieht atomar update ab; der Standardwert ist 1. Es muss 0 <= update gelten, und update darf den aktuellen Zählerstand nicht überschreiten. Rufe daher count_down() nicht mit dem Standardwert auf, wenn der Zähler bereits null ist. Diese Methode wartet nicht auf weitere Meldungen. std::latch::wait() verringert den Zähler nicht: Die Methode blockiert, bis er null ist, oder kehrt sofort zurück, wenn er bereits null ist. Bleiben Meldungen aus, kann das Warten unbegrenzt andauern.

In C++23 steht count_down() in einer strongly happens-before-Beziehung zur Rückkehr von Aufrufen, deren Blockierung an diesem Latch aufgehoben wird. Diese Garantie gilt nicht ausdrücklich für einen Aufruf von wait(), der erst beginnt, nachdem der Zähler null erreicht hat. Im Beispiel kann worker schon count_down() aufrufen, bevor der Hauptthread wait() aufruft. wait() allein garantiert daher nicht, dass der nicht atomare Lesezugriff auf result bei jeder Thread-Planung sicher ist. Das Latch schützt auch nicht vor beliebigen gleichzeitigen Schreibzugriffen auf gemeinsam genutzte Daten.

Das Objekt muss während der Operationen darauf am Leben bleiben. Im Beispiel wird worker vor done zerstört, aber der Hauptthread verlässt sich nicht auf den Destruktor von std::jthread: Er ruft nach wait() und vor dem Lesen von result ausdrücklich worker.join() auf. Das Ende des Workerthreads synchronisiert sich mit der erfolgreichen Rückkehr aus worker.join(). Der Lesezugriff auf result ist daher sicher, unabhängig davon, ob wait() blockiert hat. Bei erfolgreicher Ausführung gibt das Programm 42 gefolgt von einem Zeilenumbruch aus.

Beispiele

#include <iostream>
#include <latch>
#include <thread>

int main() {
    int result = 0;
    std::latch done{1};

    std::jthread worker([&] {
        result = 42;
        done.count_down();
    });

    done.wait();
    worker.join();
    std::cout << result << '\n';
}

Ergebnis

42

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen