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

CKTIS / C++

std::stop_token::stop_requested — kontrola požadavku na zastavení

Zjisti, zda sdílený stav zastavení přijal požadavek, aby šlo práci ukončit na bezpečném místě. Výsledek `true` neznamená, že vlákno už skončilo.

Verze: ISO C++23; implementation support may vary

Syntaxe

bool stop_requested() const noexcept;

std::stop_token::stop_requested je členská funkce z hlavičky <stop_token>, zavedená v C++20 a dostupná v C++23. Volání token.stop_requested() nemá argumenty a funkce je const noexcept. Vrací true pouze tehdy, když přidružený stav zastavení přijal požadavek na zastavení. Jinak vrací false, a to i pro výchozím konstruktorem vytvořený token, který žádný stav nemá.

std::stop_source::get_token() vrací token, který se zdrojem sdílí stav zastavení, nikoli kopii aktuální hodnoty příznaku. Token udržuje stav při životě, takže zničení zdroje nevymaže zaznamenaný požadavek. token.stop_possible() odpovídá na jinou otázku: vrací true, pokud už byl požadavek zadán nebo stále existuje přidružený zdroj, který jej může zadat.

std::stop_source::request_stop() zadává požadavek a vrací true jen tehdy, když zaznamená první požadavek pro daný stav. Pokud už byl požadavek zadán nebo zdroj nemá žádný stav, vrací false. Požadavek nelze odvolat. std::jthread::request_stop() pracuje s interním zdrojem objektu std::jthread; token získaný pomocí get_stop_token() sleduje stejný stav.

Rušení je kooperativní: kontroluj token mezi jednotlivými úseky práce a skonči na bezpečném místě. true oznamuje požadavek, nikoli ukončení vlákna. Samotný požadavek nepřeruší libovolnou blokující operaci.

Příklady

#include <iostream>
#include <stop_token>

int main() {
    std::stop_token token;
    std::cout << std::boolalpha;

    {
        std::stop_source source;
        token = source.get_token();
        std::cout << "Before request: " << token.stop_requested() << '\n';
        std::cout << "First request: " << source.request_stop() << '\n';
        std::cout << "Repeated request: " << source.request_stop() << '\n';
    }

    std::cout << "After source destruction: " << token.stop_requested() << '\n';
    std::cout << "Empty token: " << std::stop_token{}.stop_requested() << '\n';
}

Výsledek

Before request: false
First request: true
Repeated request: false
After source destruction: true
Empty token: false

Program nespouští žádná vlákna. První požadavek se zaznamená a druhý nic nezmění. Token vidí požadavek i po zničení zdroje; prázdný token vrací `false`.

Související lekce

  • C++ · Lekce 39 · Pokročilá · Verze: 3
  • C++ · Lekce 44 · Pokročilá · Verze: 3

Zdroje