Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje