CKTIS / C++
std::latch — enkratno čakanje, da števec doseže nič
std::latch iz glave <latch> omogoča nitim, da počakajo, da števec doseže nič. count_down() sporoči dokončanje dela naloge, wait() pa počaka na konec odštevanja, ne da bi spremenil števec.
Različica: C++23; repository compiler flag, production runtime not attested
Sintaksa
#include <latch>
std::latch done{expected};
done.count_down();
done.wait();std::latch je enkratni sinhronizacijski mehanizem iz <latch>. Njegov konstruktor nastavi števec na expected, za katerega mora veljati 0 <= expected && expected <= std::latch::max(). Števec predstavlja število obvestil, ki jih je še treba prejeti in ki ne prihajajo nujno iz različnih niti. Ko števec doseže nič, objekta ni mogoče ponastaviti ali znova uporabiti v drugem krogu.
std::latch::count_down(update) atomsko odšteje update; privzeta vrednost je 1. Veljati mora 0 <= update, vrednost update pa ne sme presegati trenutne vrednosti števca. Zato ne kličite count_down() s privzeto vrednostjo, ko je števec že nič. Ta metoda ne čaka na druga obvestila. std::latch::wait() števca ne zmanjša: klic je blokiran, dokler števec ne doseže nič, ali pa se takoj vrne, če je števec že nič. Če katero od obvestil manjka, lahko čakanje traja neomejeno dolgo.
V C++23 je count_down() v relaciji strongly happens-before z vrnitvijo klicev, ki se odblokirajo na tej pregradi. To jamstvo izrecno ne zajema klica wait(), ki se začne šele po tem, ko števec doseže nič. V primeru lahko worker pokliče count_down(), še preden glavna nit pokliče wait(). Sam klic wait() zato ne zagotavlja, da je neatomsko branje result varno pri vsakem razporejanju niti. Pregrada tudi ne ščiti pred poljubnimi sočasnimi zapisi v skupne podatke.
Objekt mora ostati živ med operacijami, ki se izvajajo nad njim. V primeru se worker uniči pred done, vendar se glavna nit ne zanaša na destruktor std::jthread: po klicu wait() in pred branjem result izrecno pokliče worker.join(). Zaključek delovne niti se sinhronizira z uspešno vrnitvijo iz worker.join(), zato je branje result varno ne glede na to, ali je klic wait() blokiral. Ob uspešni izvedbi program izpiše 42, ki mu sledi znak za novo vrstico.
Primeri
#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';
}
Rezultat
42
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.