Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori