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