Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C++

std::stop_source — vir zahtev za ustavitev

std::stop_source zagotavlja skupno stanje zahteve za ustavitev. Funkcija get_token() omogoča opazovanje tega stanja, request_stop() pa zahteva ustavitev. Gre za sodelovalni mehanizem: delujoče niti ne prekine samodejno.

Različica: C++23; repository compiler flag, production runtime not attested

Sintaksa

#include <stop_token>

std::stop_source source;
std::stop_token token = source.get_token();
bool first_request = source.request_stop();

// Member signatures:
// std::stop_token get_token() const noexcept;
// bool request_stop() noexcept;

std::stop_source iz glave <stop_token> podpira sodelovalno ustavljanje. Privzeta konstrukcija ustvari novo stanje, v katerem ustavitev še ni bila zahtevana; kopije vira si to stanje delijo. Koda, ki opravlja delo, mora preverjati žeton ali uporabiti mehanizem, ki se odzove na zahtevo za ustavitev. Vir sam niti ne zažene niti ne konča niti.

std::stop_source::get_token() ima podpis std::stop_token get_token() const noexcept. Vrne žeton, povezan s stanjem vira. Žeton lahko zahteve opazuje prek stop_requested(), ne more pa zahtevati ustavitve. Vir, ustvarjen kot std::stop_source{std::nostopstate}, nima stanja: get_token() tedaj vrne prazen žeton, request_stop() pa vrne false.

std::stop_source::request_stop() ima podpis bool request_stop() noexcept. Atomsko poda prvo zahtevo za skupno stanje in vrne true samo pri klicu, ki jo je podal. Poznejši klici vrnejo false; to ne pomeni napake in ne potrjuje, da je delo končano. Zahteve ni mogoče preklicati: za nov cikel je potrebno novo stanje.

Registrirani povratni klici se ob prvi zahtevi izvedejo sinhrono, zato lahko request_stop() pred vrnitvijo izvede uporabniško kodo. Izjema, ki uide iz takega klica, povzroči std::terminate. Primer namenoma ne ustvari niti: deterministično prikaže spremembo stanja, ki jo je mogoče opazovati prek žetona.

Primeri

#include <iostream>
#include <stop_token>

int main() {
    std::stop_source source;
    const std::stop_token token = source.get_token();

    std::cout << std::boolalpha;
    std::cout << "before: " << token.stop_requested() << '\n';

    const bool first = source.request_stop();
    const bool second = source.request_stop();

    std::cout << "requests: " << first << ' ' << second << '\n';
    std::cout << "after: " << token.stop_requested() << '\n';
}

Rezultat

before: false
requests: true false
after: true

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri