CKTIS / C++
std::stop_source — zdroj požadavků na zastavení
std::stop_source poskytuje sdílený stav požadavku na zastavení. Funkce get_token() umožňuje tento stav sledovat a request_stop() žádá o zastavení. Jde o kooperativní mechanismus: běžící vlákno automaticky nepřeruší.
Verze: C++23; repository compiler flag, production runtime not attested
Syntaxe
#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 kooperativní zastavení. Výchozí konstrukce vytvoří nový stav, ve kterém nebylo požádáno o zastavení; kopie zdroje tento stav sdílejí. Kód vykonávající práci musí kontrolovat token nebo použít mechanismus, který na požadavek zastavení reaguje. Samotný zdroj vlákno nespouští ani neukončuje.
std::stop_source::get_token() má signaturu std::stop_token get_token() const noexcept. Vrací token spojený se stavem zdroje. Token může sledovat požadavky pomocí stop_requested(), ale nemůže zastavení vyžádat. Zdroj vytvořený jako std::stop_source{std::nostopstate} nemá stav: get_token() pak vrací prázdný token a request_stop() vrací false.
std::stop_source::request_stop() má signaturu bool request_stop() noexcept. Atomicky provede první požadavek pro sdílený stav a hodnotu true vrátí pouze volání, které jej provedlo. Další volání vracejí false; neznamená to chybu ani potvrzení, že práce skončila. Požadavek nelze vzít zpět: nový cyklus vyžaduje nový stav.
Registrovaná zpětná volání se při prvním požadavku vykonají synchronně, takže request_stop() může před návratem spustit uživatelský kód. Výjimka unikající z takového volání způsobí std::terminate. Příklad záměrně nevytváří žádná vlákna: deterministicky ukazuje změnu stavu pozorovanou prostřednictvím tokenu.
Pří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ýsledek
before: false requests: true false after: true
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.