CKTIS / C++
std::latch — jednorazové čakanie, kým počítadlo dosiahne nulu
std::latch z hlavičky <latch> umožňuje vláknam čakať, kým počítadlo dosiahne nulu. count_down() oznámi dokončenie časti práce, zatiaľ čo wait() čaká na koniec odpočítavania bez zmeny počítadla.
Verzia: C++23; repository compiler flag, production runtime not attested
Syntax
#include <latch>
std::latch done{expected};
done.count_down();
done.wait();std::latch je jednorazový synchronizačný mechanizmus z <latch>. Jeho konštruktor nastaví počítadlo na expected, pričom musí platiť 0 <= expected && expected <= std::latch::max(). Počítadlo predstavuje počet zostávajúcich oznámení, nie nevyhnutne počet rôznych vlákien. Keď dosiahne nulu, objekt nemožno resetovať ani použiť v ďalšom kole.
std::latch::count_down(update) atomicky odčíta update; predvolená hodnota je 1. Musí platiť 0 <= update a update nesmie prekročiť aktuálnu hodnotu počítadla. Preto nevolajte count_down() s predvolenou hodnotou, ak je počítadlo už nulové. Táto metóda nečaká na ďalšie oznámenia. std::latch::wait() počítadlo neznižuje: blokuje, kým počítadlo nedosiahne nulu, alebo sa okamžite vráti, ak už je nulové. Chýbajúce oznámenia môžu spôsobiť neobmedzené čakanie.
V C++23 volanie count_down() v zmysle vzťahu strongly happens-before predchádza návratu z volaní, ktoré sa na tejto závore odblokujú. Táto záruka sa výslovne nevzťahuje na volanie wait(), ktoré sa začne až po dosiahnutí nuly. V príklade môže worker zavolať count_down() skôr, než hlavné vlákno zavolá wait(). Samotné wait() teda nezaručuje, že neatómové čítanie result je bezpečné pri každom plánovaní vlákien. Závora nechráni ani pred ľubovoľnými súbežnými zápismi do zdieľaných údajov.
Objekt musí zostať živý počas operácií, ktoré sa ho týkajú. V príklade sa worker zničí pred done, hlavné vlákno sa však nespolieha na deštruktor std::jthread: po volaní wait() a pred čítaním result výslovne volá worker.join(). Skončenie pracovného vlákna sa synchronizuje s úspešným návratom z worker.join(), takže čítanie result je bezpečné bez ohľadu na to, či volanie wait() blokovalo. Pri úspešnom vykonaní program vypíše 42 a za ním znak nového riadka.
Prí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ýsledok
42
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metodou zaznamenanou v dôkaze o overení tejto presnej verzie.