Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje