Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::latch — jednorazowe oczekiwanie na wyzerowanie licznika

std::latch z nagłówka <latch> pozwala wątkom czekać na wyzerowanie licznika. count_down() zgłasza wykonanie części pracy, a wait() czeka na zakończenie odliczania bez zmiany licznika.

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

Składnia

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

std::latch to jednorazowy mechanizm synchronizacji z nagłówka <latch>. Konstruktor ustala licznik expected, dla którego musi zachodzić 0 <= expected && expected <= std::latch::max(). Licznik opisuje liczbę pozostałych zgłoszeń, niekoniecznie liczbę różnych wątków. Po osiągnięciu zera obiektu nie można zresetować ani użyć do kolejnej rundy.

std::latch::count_down(update) atomowo odejmuje update, domyślnie 1. Wymagane jest 0 <= update, a update nie może przekraczać bieżącego licznika; nie wywołuj więc domyślnego count_down() po osiągnięciu zera. Metoda nie czeka na pozostałe zgłoszenia. std::latch::wait() nie zmniejsza licznika: blokuje do zera albo wraca od razu, gdy licznik już wynosi zero. Brak wymaganych zgłoszeń może oznaczać oczekiwanie bez końca.

W C++23 wywołanie count_down() poprzedza w sensie relacji strongly happens-before powroty z wywołań odblokowanych na tym obiekcie std::latch. Ta gwarancja nie obejmuje wprost wait() wywołanego po wyzerowaniu licznika. W przykładzie worker może wywołać count_down(), zanim wątek główny wywoła wait(). Samo wait() nie wystarcza więc, by zagwarantować bezpieczny nieatomowy odczyt result niezależnie od kolejności planowania wątków. Mechanizm ten nie chroni też przed dowolnymi równoczesnymi zapisami do wspólnych danych.

Obiekt musi pozostać żywy podczas operacji na nim. W przykładzie worker jest niszczony przed done, ale wątek główny nie polega na destruktorze std::jthread: jawnie wywołuje worker.join() po wait(), a przed odczytem result. Zakończenie wątku roboczego synchronizuje się z pomyślnym powrotem z worker.join(), więc odczyt result jest bezpieczny niezależnie od tego, czy wait() się zablokowało. Przy pomyślnym wykonaniu program wypisuje 42 i znak nowego wiersza.

Przykłady

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

Wynik

42

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła