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

CKTIS / C++

std::stop_token — sodelovalna ustavitev operacij

std::stop_token omogoča operaciji preverjanje, ali je bila podana zahteva za ustavitev. stop_requested() bere stanje v skupni rabi; žeton sam ne ustavi niti niti ne poda zahteve.

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 requested = token.stop_requested();
// Member signature: bool stop_requested() const noexcept;

std::stop_token iz glave <stop_token> podpira sodelovalno ustavljanje operacij. std::stop_source zagotovi žeton prek get_token() in poda zahtevo prek request_stop(). Kopije žetona si delijo stanje ustavitve, če obstaja. Koda operacije se mora na zahtevo odzvati sama; ne gre za prisilno prekinitev niti.

std::stop_token::stop_requested() ima podpis bool stop_requested() const noexcept;. Vrne true, ko povezano stanje prejme zahtevo za ustavitev, sicer pa false. Zahteve ni mogoče preklicati. Vrednost false ne zagotavlja, da zahteva ne bo prispela takoj zatem.

stop_possible() odgovarja na drugo vprašanje: vrne false, če žeton nima stanja ali če ni bila podana nobena zahteva in ni več povezanega std::stop_source. V vseh drugih primerih vrne true, tudi po podani zahtevi. Pri privzeto ustvarjenem žetonu obe metodi vrneta false.

Primer namenoma ne ustvari nobene niti, zato je njegov izpis determinističen. Prikazuje prazen žeton in povezan žeton pred zahtevo ter po njej. Ta vnos obravnava C++23; priloženi delovni osnutek je sproti razvijan dokument, ne zamrznjena izdaja C++23.

Primeri

#include <iostream>
#include <stop_token>

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

    std::cout << std::boolalpha;
    std::cout << empty.stop_possible() << ' '
              << empty.stop_requested() << '\n';
    std::cout << token.stop_possible() << ' '
              << token.stop_requested() << '\n';
    source.request_stop();
    std::cout << token.stop_possible() << ' '
              << token.stop_requested() << '\n';
}

Rezultat

false false
true false
true 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