Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / C++

std::stop_source — izvor zahtjeva za zaustavljanje

std::stop_source pruža zajedničko stanje zahtjeva za zaustavljanje. get_token() omogućuje promatranje tog stanja, a request_stop() traži zaustavljanje. To je kooperativni mehanizam: ne prekida automatski nit koja se izvršava.

Verzija: 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 zaglavlja <stop_token> podržava kooperativno zaustavljanje. Zadana konstrukcija stvara novo stanje bez zahtjeva za zaustavljanje; kopije izvora dijele to stanje. Kod koji obavlja posao mora provjeravati token ili upotrijebiti mehanizam koji reagira na zahtjev za zaustavljanje. Sam izvor ne pokreće niti završava nit.

std::stop_source::get_token() ima potpis std::stop_token get_token() const noexcept. Vraća token povezan sa stanjem izvora. Token može promatrati zahtjeve putem stop_requested(), ali ne može zatražiti zaustavljanje. Izvor konstruiran kao std::stop_source{std::nostopstate} nema stanje: get_token() tada vraća prazan token, a request_stop() vraća false.

std::stop_source::request_stop() ima potpis bool request_stop() noexcept. Atomski podnosi prvi zahtjev za zajedničko stanje i vraća true samo u pozivu koji ga je podnio. Sljedeći pozivi vraćaju false; to ne znači da je došlo do pogreške niti potvrđuje da je posao dovršen. Zahtjev se ne može poništiti: za novi ciklus potrebno je novo stanje.

Registrirani povratni pozivi izvršavaju se sinkrono pri prvom zahtjevu, pa request_stop() može izvršiti korisnički kod prije povratka. Iznimka koja izađe iz takvog poziva uzrokuje std::terminate. Primjer namjerno ne stvara niti: deterministički prikazuje promjenu stanja koja se opaža putem tokena.

Primjeri

#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

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori