CKTIS / C++
std::stop_token — kooperatives Beenden von Operationen
Mit std::stop_token kann eine Operation prüfen, ob eine Stoppanforderung gestellt wurde. stop_requested() liest den gemeinsamen Zustand; der Token selbst beendet weder einen Thread noch stellt er eine Anforderung.
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 requested = token.stop_requested();
// Member signature: bool stop_requested() const noexcept;std::stop_token aus dem Header <stop_token> unterstützt das kooperative Beenden von Operationen. Ein std::stop_source stellt über get_token() einen Token bereit und löst über request_stop() eine Anforderung aus. Token-Kopien teilen sich gegebenenfalls den Stoppzustand. Der Code der Operation muss selbst auf die Anforderung reagieren; es handelt sich nicht um eine erzwungene Unterbrechung des Threads.
std::stop_token::stop_requested() hat die Signatur bool stop_requested() const noexcept;. Die Methode gibt true zurück, wenn der zugehörige Zustand eine Stoppanforderung erhalten hat, andernfalls false. Eine Anforderung kann nicht zurückgenommen werden. Ein Ergebnis von false garantiert nicht, dass nicht unmittelbar danach eine Anforderung eingeht.
stop_possible() beantwortet eine andere Frage: Die Methode gibt false zurück, wenn der Token keinen Zustand hat oder wenn noch keine Anforderung gestellt wurde und keine zugehörige std::stop_source mehr existiert. Andernfalls gibt sie true zurück, auch nach einer Anforderung. Bei einem standardmäßig erzeugten Token geben beide Methoden false zurück.
Das Beispiel erstellt absichtlich keine Threads, damit die Ausgabe deterministisch ist. Es zeigt einen leeren Token sowie einen zugehörigen Token vor und nach einer Anforderung. Dieser Eintrag behandelt C++23; der angegebene Arbeitsentwurf ist ein fortlaufend weiterentwickeltes Dokument und keine eingefrorene C++23-Ausgabe.
Beispiele
#include <iostream>
#include <stop_token>
int main() {
std::stop_source source;
std::stop_token token = source.get_token();
std::stop_token empty;
std::cout << std::boolalpha;
std::cout << empty.stop_possible() << ' '
<< empty.stop_requested() << '\n';
std::cout << token.stop_possible() << ' '
<< token.stop_requested() << '\n';
source.request_stop();
std::cout << token.stop_possible() << ' '
<< token.stop_requested() << '\n';
}
Ergebnis
false false true false true 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.