WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::stop_source — Quelle für Stoppanforderungen

std::stop_source stellt einen gemeinsam genutzten Zustand für Stoppanforderungen bereit. get_token() ermöglicht dessen Beobachtung, und request_stop() fordert einen Stopp an. Dies ist ein kooperativer Mechanismus: Ein laufender Thread wird nicht automatisch unterbrochen.

Version: 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 aus dem Header <stop_token> unterstützt kooperatives Beenden. Die Standardkonstruktion erstellt einen neuen Zustand, für den kein Stopp angefordert wurde; Kopien der Quelle teilen diesen Zustand. Ausführender Code muss ein Token prüfen oder einen Mechanismus verwenden, der auf eine Stoppanforderung reagiert. Die Quelle selbst startet und beendet keinen Thread.

std::stop_source::get_token() hat die Signatur std::stop_token get_token() const noexcept. Die Funktion gibt ein Token zurück, das dem Zustand der Quelle zugeordnet ist. Über stop_requested() kann das Token Anforderungen beobachten, aber keinen Stopp anfordern. Eine als std::stop_source{std::nostopstate} konstruierte Quelle hat keinen Zustand: get_token() gibt dann ein leeres Token zurück und request_stop() gibt false zurück.

std::stop_source::request_stop() hat die Signatur bool request_stop() noexcept. Die Funktion stellt atomar die erste Anforderung für den gemeinsam genutzten Zustand und gibt nur bei dem Aufruf true zurück, der sie gestellt hat. Weitere Aufrufe geben false zurück; das bedeutet weder einen Fehler noch eine Bestätigung, dass die Arbeit beendet ist. Eine Anforderung lässt sich nicht rückgängig machen: Für einen neuen Durchlauf ist ein neuer Zustand erforderlich.

Registrierte Callbacks werden beim ersten Anfordern synchron ausgeführt. Daher kann request_stop() vor seiner Rückkehr Benutzercode ausführen. Eine Ausnahme, die aus einem solchen Callback entweicht, führt zu std::terminate. Das Beispiel erstellt bewusst keine Threads: Es zeigt deterministisch die Zustandsänderung, die über das Token beobachtet wird.

Beispiele

#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';
}

Ergebnis

before: false
requests: true false
after: true

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen