CKTIS / C++
std::stop_source — zdroj požiadaviek na zastavenie
std::stop_source poskytuje zdieľaný stav požiadavky na zastavenie. Funkcia get_token() umožňuje tento stav sledovať a request_stop() žiada o zastavenie. Ide o kooperatívny mechanizmus: bežiace vlákno automaticky nepreruší.
Verzia: C++23; repository compiler flag, production runtime not attested
Syntax
#include <stop_token>
std::stop_source source;
std::stop_token token = source.get_token();
bool first_request = source.request_stop();
// Member signatures:
// std::stop_token get_token() const noexcept;
// bool request_stop() noexcept;std::stop_source z hlavičky <stop_token> podporuje kooperatívne zastavenie. Predvolená konštrukcia vytvorí nový stav, v ktorom sa nepožiadalo o zastavenie; kópie zdroja tento stav zdieľajú. Kód vykonávajúci prácu musí kontrolovať token alebo použiť mechanizmus, ktorý reaguje na požiadavku zastavenia. Samotný zdroj vlákno nespúšťa ani neukončuje.
std::stop_source::get_token() má signatúru std::stop_token get_token() const noexcept. Vráti token priradený k stavu zdroja. Token môže sledovať požiadavky pomocou stop_requested(), ale nemôže zastavenie vyžiadať. Zdroj vytvorený ako std::stop_source{std::nostopstate} nemá stav: get_token() potom vráti prázdny token a request_stop() vráti false.
std::stop_source::request_stop() má signatúru bool request_stop() noexcept. Atomicky vykoná prvú požiadavku pre zdieľaný stav a hodnotu true vráti iba volanie, ktoré ju vykonalo. Ďalšie volania vracajú false; neznamená to zlyhanie ani potvrdenie, že sa práca skončila. Požiadavku nemožno vziať späť: nový cyklus vyžaduje nový stav.
Registrované spätné volania sa pri prvej požiadavke vykonajú synchrónne, takže request_stop() môže pred návratom vykonať používateľský kód. Výnimka unikajúca z takého volania spôsobí std::terminate. Príklad zámerne nevytvára vlákna: deterministicky ukazuje zmenu stavu pozorovanú prostredníctvom tokenu.
Príklady
#include <iostream>
#include <stop_token>
int main() {
std::stop_source source;
const std::stop_token token = source.get_token();
std::cout << std::boolalpha;
std::cout << "before: " << token.stop_requested() << '\n';
const bool first = source.request_stop();
const bool second = source.request_stop();
std::cout << "requests: " << first << ' ' << second << '\n';
std::cout << "after: " << token.stop_requested() << '\n';
}
Výsledok
before: false requests: true false after: true
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.