CKTIS / C++
std::stop_token::stop_requested — kontrola požiadavky na zastavenie
Zisti, či zdieľaný stav zastavenia prijal požiadavku, aby sa práca dala ukončiť na bezpečnom mieste. Výsledok `true` neznamená, že vlákno už skončilo.
Verzia: ISO C++23; implementation support may vary
Syntax
bool stop_requested() const noexcept;std::stop_token::stop_requested je členská funkcia z hlavičky <stop_token>, zavedená v C++20 a dostupná v C++23. Volanie token.stop_requested() nemá argumenty a funkcia je const noexcept. Vracia true iba vtedy, keď pridružený stav zastavenia prijal požiadavku na zastavenie. Inak vracia false, aj pri tokene vytvorenom predvoleným konštruktorom, ktorý nemá žiadny stav.
std::stop_source::get_token() vracia token, ktorý so zdrojom zdieľa stav zastavenia, nie kópiu aktuálnej hodnoty príznaku. Token udržiava stav pri živote, takže zničenie zdroja nevymaže zaznamenanú požiadavku. token.stop_possible() odpovedá na inú otázku: vracia true, ak už bola podaná požiadavka alebo stále existuje pridružený zdroj, ktorý ju môže podať.
std::stop_source::request_stop() podáva požiadavku a vracia true iba vtedy, keď zaznamená prvú požiadavku pre daný stav. Ak už bola požiadavka podaná alebo zdroj nemá žiadny stav, vracia false. Požiadavku nemožno odvolať. std::jthread::request_stop() pracuje s interným zdrojom objektu std::jthread; token získaný pomocou get_stop_token() sleduje ten istý stav.
Rušenie je kooperatívne: kontroluj token medzi jednotlivými úsekmi práce a skonči na bezpečnom mieste. true oznamuje požiadavku, nie ukončenie vlákna. Samotná požiadavka nepreruší ľubovoľnú blokujúcu operáciu.
Prí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ýsledok
Before request: false First request: true Repeated request: false After source destruction: true Empty token: false
Program nespúšťa žiadne vlákna. Prvá požiadavka sa zaznamená a druhá nič nezmení. Token vidí požiadavku aj po zničení zdroja; prázdny token vracia `false`.
Súvisiace lekcie
- C++ · Lekcia 39 · Pokročilá · Verzia: 3
- C++ · Lekcia 44 · Pokročilá · Verzia: 3