Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C++

std::stop_token — kooperatívne zastavenie operácií

std::stop_token umožňuje operácii zistiť, či bola vznesená požiadavka na zastavenie. stop_requested() číta zdieľaný stav; samotný token nezastaví vlákno ani nevznesie požiadavku.

Verzia: C++23; repository compiler flag, production runtime not attested

Syntax

#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 z hlavičky <stop_token> podporuje kooperatívne zastavovanie operácií. Objekt std::stop_source poskytuje token pomocou get_token() a vznesenie požiadavky umožňuje pomocou request_stop(). Kópie tokenu zdieľajú stav zastavenia, ak existuje. Kód operácie musí na požiadavku reagovať sám; nejde o vynútené prerušenie vlákna.

std::stop_token::stop_requested() má signatúru bool stop_requested() const noexcept;. Vráti true, ak pridružený stav dostal požiadavku na zastavenie, inak vráti false. Požiadavku nemožno odvolať. Hodnota false nezaručuje, že požiadavka nepríde vzápätí.

stop_possible() odpovedá na inú otázku: vráti false, ak token nemá stav alebo ak nebola vznesená žiadna požiadavka a nezostáva žiadny pridružený std::stop_source. V ostatných prípadoch vráti true, a to aj po vznesení požiadavky. Pri tokene vytvorenom predvoleným spôsobom vrátia obe metódy false.

Príklad zámerne nevytvára žiadne vlákna, takže jeho výstup je deterministický. Ukazuje prázdny token a pridružený token pred vznesením požiadavky aj po ňom. Tento záznam sa týka C++23; dodaný pracovný návrh je priebežne vyvíjaný dokument, nie nemenné vydanie C++23.

Príklady

#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';
}

Výsledok

false false
true false
true true

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje