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.