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