CKTIS / C++
std::latch — eenmalig wachten tot een teller nul bereikt
std::latch uit <latch> laat threads wachten tot een teller nul bereikt. count_down() meldt dat een deel van het werk is voltooid; wait() wacht tot het aftellen klaar is zonder de teller te wijzigen.
Versie: C++23; repository compiler flag, production runtime not attested
Syntax
#include <latch>
std::latch done{expected};
done.count_down();
done.wait();std::latch is een eenmalig synchronisatiemechanisme uit <latch>. De constructor stelt de teller in op expected, waarvoor 0 <= expected && expected <= std::latch::max() moet gelden. De teller staat voor meldingen die nog moeten binnenkomen, niet noodzakelijk van verschillende threads. Zodra de teller nul bereikt, kan het object niet worden teruggezet of voor een volgende ronde worden gebruikt.
std::latch::count_down(update) trekt update atomair af; de standaardwaarde is 1. Hiervoor moet 0 <= update gelden en update mag de huidige tellerstand niet overschrijden. Roep count_down() daarom niet aan met de standaardwaarde wanneer de teller al nul is. Deze methode wacht niet op andere meldingen. std::latch::wait() verlaagt de teller niet: de methode blokkeert totdat de teller nul is, of keert meteen terug als dat al zo is. Als meldingen uitblijven, kan het wachten onbeperkt duren.
In C++23 gaat count_down() in de zin van de strongly happens-before-relatie vooraf aan het terugkeren van aanroepen die op de latch worden gedeblokkeerd. Deze garantie geldt niet uitdrukkelijk voor een aanroep van wait() die begint nadat de teller nul heeft bereikt. In het voorbeeld kan worker al count_down() aanroepen voordat de hoofdthread wait() aanroept. wait() alleen garandeert daarom niet dat het niet-atomaire lezen van result bij elke threadplanning veilig is. De latch beschermt ook niet tegen willekeurige gelijktijdige schrijfbewerkingen naar gedeelde gegevens.
Het object moet in leven blijven zolang er bewerkingen op worden uitgevoerd. In het voorbeeld wordt worker vóór done vernietigd, maar de hoofdthread vertrouwt niet op de destructor van std::jthread: hij roept worker.join() expliciet aan na wait() en voordat hij result leest. Het beëindigen van de workerthread synchroniseert met de succesvolle terugkeer uit worker.join(). Daardoor kan result veilig worden gelezen, ongeacht of wait() heeft geblokkeerd. Bij een geslaagde uitvoering geeft het programma 42 weer, gevolgd door een regeleinde.
Voorbeelden
#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';
}
Resultaat
42
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.