CKTIS / C++
std::stop_token::stop_requested — provjera zahtjeva za zaustavljanje
Provjeri je li zajedničko stanje zaustavljanja primilo zahtjev kako bi posao mogao završiti na sigurnom mjestu. Rezultat `true` ne znači da je dretva već završila.
Verzija: ISO C++23; implementation support may vary
Sintaksa
bool stop_requested() const noexcept;std::stop_token::stop_requested je funkcija članica iz zaglavlja <stop_token>, uvedena u C++20 i dostupna u C++23. Poziv token.stop_requested() ne prima argumente, a funkcija je const noexcept. Vraća true samo ako je pridruženo stanje zaustavljanja primilo zahtjev za zaustavljanje. Inače vraća false, pa tako i za token stvoren zadanim konstruktorom, koji nema pridruženo stanje.
std::stop_source::get_token() vraća token koji s izvorom dijeli stanje zaustavljanja, a ne kopiju trenutačne vrijednosti zastavice. Token održava to stanje na životu, pa uništavanje izvora ne briše zabilježeni zahtjev. token.stop_possible() odgovara na drugo pitanje: vraća true ako je zahtjev već podnesen ili još postoji pridruženi izvor koji ga može podnijeti.
std::stop_source::request_stop() podnosi zahtjev i vraća true samo kada zabilježi prvi zahtjev za to stanje. Vraća false ako je zahtjev već podnesen ili ako izvor nema stanje. Zahtjev se ne može povući. std::jthread::request_stop() djeluje na interni izvor objekta std::jthread; token dobiven pozivom get_stop_token() promatra isto stanje.
Otkazivanje je kooperativno: provjeravaj token između pojedinih dijelova posla i završi na sigurnom mjestu. true označava zahtjev, a ne završetak dretve. Sam zahtjev ne prekida proizvoljnu blokirajuću operaciju.
Primjeri
#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 pokreće dretve. Prvi se zahtjev bilježi, a drugi ništa ne mijenja. Token i nakon uništavanja izvora vidi zahtjev; prazan token vraća `false`.
Povezane lekcije
- C++ · Lekcija 39 · Napredno · Verzija: 3
- C++ · Lekcija 44 · Napredno · Verzija: 3