Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C++

std::latch — jednorázové čekání, až čítač dosáhne nuly

std::latch z hlavičky <latch> umožňuje vláknům čekat, až čítač dosáhne nuly. count_down() oznámí dokončení části práce, zatímco wait() čeká na konec odpočítávání, aniž by čítač změnila.

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

Syntaxe

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

std::latch je jednorázový synchronizační mechanismus z <latch>. Jeho konstruktor nastaví čítač na expected, přičemž musí platit 0 <= expected && expected <= std::latch::max(). Čítač představuje počet zbývajících oznámení, nikoli nutně počet různých vláken. Jakmile dosáhne nuly, objekt nelze resetovat ani použít v dalším kole.

std::latch::count_down(update) atomicky odečte update; výchozí hodnota je 1. Musí platit 0 <= update a update nesmí překročit aktuální hodnotu čítače. Nevolejte tedy count_down() s výchozí hodnotou, pokud je čítač už nulový. Tato metoda nečeká na další oznámení. std::latch::wait() čítač nesnižuje: blokuje, dokud čítač nedosáhne nuly, nebo se ihned vrátí, pokud už je nulový. Chybějící oznámení mohou způsobit neomezené čekání.

V C++23 volání count_down() ve smyslu relace strongly happens-before předchází návratu z volání, která se na této závoře odblokují. Tato záruka se výslovně nevztahuje na volání wait(), které začne až po dosažení nuly. V příkladu může worker zavolat count_down() dříve, než hlavní vlákno zavolá wait(). Samotné wait() tedy nezaručuje, že neatomické čtení result je bezpečné při každém plánování vláken. Závora také nechrání před libovolnými souběžnými zápisy do sdílených dat.

Objekt musí zůstat živý po dobu operací, které se ho týkají. V příkladu je worker zničen před done, hlavní vlákno se však nespoléhá na destruktor std::jthread: po volání wait() a před čtením result výslovně volá worker.join(). Ukončení pracovního vlákna se synchronizuje s úspěšným návratem z worker.join(), takže čtení result je bezpečné bez ohledu na to, zda volání wait() blokovalo. Při úspěšném běhu program vypíše 42 následované znakem nového řádku.

Příklady

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

Výsledek

42

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje