CKTIS / C++
std::stop_token — kooperativní zastavení operací
std::stop_token umožňuje operaci zjistit, zda byl vznesen požadavek na zastavení. stop_requested() čte sdílený stav; samotný token nezastaví vlákno ani požadavek nevznáší.
Verze: C++23; repository compiler flag, production runtime not attested
Syntaxe
#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 kooperativní zastavování operací. Objekt std::stop_source poskytuje token pomocí get_token() a vznesení požadavku umožňuje pomocí request_stop(). Kopie tokenu sdílejí stav zastavení, pokud existuje. Kód operace musí na požadavek reagovat sám; nejde o vynucené přerušení vlákna.
std::stop_token::stop_requested() má signaturu bool stop_requested() const noexcept;. Vrací true, pokud přidružený stav obdržel požadavek na zastavení, jinak vrací false. Požadavek nelze odvolat. Hodnota false nezaručuje, že požadavek nepřijde vzápětí.
stop_possible() odpovídá na jinou otázku: vrací false, pokud token nemá stav nebo pokud nebyl vznesen žádný požadavek a nezbývá žádný přidružený std::stop_source. V ostatních případech vrací true, a to i po vznesení požadavku. U tokenu vytvořeného výchozím způsobem vracejí obě metody false.
Příklad záměrně nevytváří žádná vlákna, takže jeho výstup je deterministický. Ukazuje prázdný token a přidružený token před vznesením požadavku i po něm. Tento záznam se týká C++23; dodaný pracovní návrh je průběžně vyvíjený dokument, nikoli neměnné vydání C++23.
Pří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ýsledek
false false true false true true
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.