Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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

Zdroje