Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C++

std::stop_token::stop_requested — preverjanje zahteve za ustavitev

Preveri, ali je skupno stanje ustavitve prejelo zahtevo, da lahko delo končaš na varnem mestu. Rezultat `true` ne pomeni, da se je nit že končala.

Različica: ISO C++23; implementation support may vary

Sintaksa

bool stop_requested() const noexcept;

std::stop_token::stop_requested je članska funkcija iz glave <stop_token>, uvedena v C++20 in na voljo v C++23. Klic token.stop_requested() nima argumentov, funkcija pa je const noexcept. Vrne true samo, če je povezano stanje ustavitve prejelo zahtevo za ustavitev. Sicer vrne false, tudi pri žetonu, ustvarjenem s privzetim konstruktorjem, ki nima povezanega stanja.

std::stop_source::get_token() vrne žeton, ki si z virom deli stanje ustavitve, ne kopije trenutne vrednosti zastavice. Žeton ohranja stanje pri življenju, zato uničenje vira ne izbriše zabeležene zahteve. token.stop_possible() odgovarja na drugo vprašanje: vrne true, če je bila zahteva že podana ali če še obstaja povezan vir, ki jo lahko poda.

std::stop_source::request_stop() poda zahtevo in vrne true samo, ko zabeleži prvo zahtevo za to stanje. Če je bila zahteva že podana ali vir nima stanja, vrne false. Zahteve ni mogoče preklicati. std::jthread::request_stop() deluje na notranji vir objekta std::jthread; žeton, pridobljen z get_stop_token(), opazuje isto stanje.

Ustavljanje je sodelovalno: preverjaj žeton med posameznimi enotami dela in končaj na varnem mestu. true označuje zahtevo, ne konca niti. Sama zahteva ne prekine poljubne blokirajoče operacije.

Primeri

#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';
}

Rezultat

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

Program ne zažene nobene niti. Prva zahteva se zabeleži, druga pa ničesar ne spremeni. Žeton zazna zahtevo tudi po uničenju vira; prazen žeton vrne `false`.

Povezane lekcije

  • C++ · Lekcija 39 · Napredna · Različica: 3
  • C++ · Lekcija 44 · Napredna · Različica: 3

Viri