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.