CKTIS / C++
std::latch — jednokratno čekanje da brojač dosegne nulu
std::latch iz zaglavlja <latch> omogućuje dretvama da čekaju dok brojač ne dosegne nulu. count_down() označava dovršetak dijela posla, a wait() čeka završetak odbrojavanja bez promjene brojača.
Verzija: C++23; repository compiler flag, production runtime not attested
Sintaksa
#include <latch>
std::latch done{expected};
done.count_down();
done.wait();std::latch je jednokratni mehanizam sinkronizacije iz <latch>. Njegov konstruktor postavlja brojač na expected, za koji mora vrijediti 0 <= expected && expected <= std::latch::max(). Brojač predstavlja broj preostalih dojava, koje ne moraju dolaziti iz različitih dretvi. Kad brojač dosegne nulu, objekt se ne može ponovno postaviti ni upotrijebiti za novi krug.
std::latch::count_down(update) atomski oduzima update; zadana je vrijednost 1. Mora vrijediti 0 <= update, a update ne smije premašiti trenutačnu vrijednost brojača. Zato nemojte pozvati count_down() sa zadanom vrijednošću kad je brojač već nula. Ova metoda ne čeka na ostale dojave. std::latch::wait() ne smanjuje brojač: poziv se blokira dok brojač ne dosegne nulu ili se odmah vraća ako je već nula. Ako neke dojave izostanu, čekanje može trajati neograničeno.
U C++23 poziv count_down() prethodi, u smislu relacije strongly happens-before, povratku iz poziva koji se odblokiraju na toj zapreci. To jamstvo ne obuhvaća izričito poziv wait() koji započne nakon što brojač dosegne nulu. U primjeru worker može pozvati count_down() prije nego što glavna dretva pozove wait(). Sam poziv wait() stoga ne jamči da je neatomsko čitanje result sigurno neovisno o raspoređivanju dretvi. Zapreka ne štiti ni od proizvoljnih istodobnih zapisa u zajedničke podatke.
Objekt mora ostati živ tijekom operacija nad njim. U primjeru se worker uništava prije done, ali glavna se dretva ne oslanja na destruktor za std::jthread: nakon poziva wait(), a prije čitanja result, izričito poziva worker.join(). Završetak radne dretve sinkronizira se s uspješnim povratkom iz poziva worker.join(), pa je čitanje result sigurno bez obzira na to je li poziv wait() blokirao. Pri uspješnom izvođenju program ispisuje 42 i zatim znak za novi redak.
Primjeri
#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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.