CKTIS / C++
std::stop_token::stop_requested — Stoppanforderung abfragen
Prüfe, ob für den gemeinsamen Stoppzustand eine Anforderung vorliegt, um die Arbeit an einer sicheren Stelle zu beenden. `true` bedeutet nicht, dass der Thread schon beendet ist.
Version: ISO C++23; implementation support may vary
Syntax
bool stop_requested() const noexcept;std::stop_token::stop_requested ist eine Memberfunktion aus <stop_token>, die seit C++20 und damit auch in C++23 verfügbar ist. token.stop_requested() nimmt keine Argumente entgegen und ist const noexcept. Die Funktion liefert nur dann true, wenn für den zugehörigen Stoppzustand eine Stoppanforderung vorliegt. Andernfalls liefert sie false, auch bei einem standardkonstruierten Token ohne Stoppzustand.
std::stop_source::get_token() liefert ein Token, das den Stoppzustand mit der Quelle teilt, keine Momentaufnahme des Flags. Das Token hält diesen Zustand am Leben; das Zerstören der Quelle löscht daher keine gespeicherte Anforderung. token.stop_possible() beantwortet eine andere Frage: Es liefert true, wenn bereits eine Anforderung vorliegt oder noch eine zugehörige Quelle existiert, die eine stellen kann.
std::stop_source::request_stop() stellt die Anforderung und liefert nur dann true, wenn es die erste Anforderung für diesen Zustand speichert. Liegt bereits eine vor oder hat die Quelle keinen Zustand, liefert es false. Eine Anforderung lässt sich nicht zurücknehmen. std::jthread::request_stop() wirkt auf die interne Quelle des std::jthread-Objekts; ein Token aus get_stop_token() beobachtet denselben Zustand.
Der Abbruch ist kooperativ: Prüfe das Token zwischen Arbeitsschritten und beende die Arbeit an einer sicheren Stelle. true meldet eine Anforderung, nicht das Ende des Threads. Die Anforderung allein unterbricht keinen beliebigen blockierenden Vorgang.
Beispiele
#include <iostream>
#include <stop_token>
int main() {
std::stop_token token;
std::cout << std::boolalpha;
{
std::stop_source source;
token = source.get_token();
std::cout << "Before request: " << token.stop_requested() << '\n';
std::cout << "First request: " << source.request_stop() << '\n';
std::cout << "Repeated request: " << source.request_stop() << '\n';
}
std::cout << "After source destruction: " << token.stop_requested() << '\n';
std::cout << "Empty token: " << std::stop_token{}.stop_requested() << '\n';
}
Ergebnis
Before request: false First request: true Repeated request: false After source destruction: true Empty token: false
Das Programm startet keine Threads. Die erste Anforderung wird gespeichert, die zweite ändert nichts. Nach dem Zerstören der Quelle bleibt die Anforderung für das Token sichtbar; das leere Token liefert `false`.
Zugehörige Lektionen
- C++ · Lektion 39 · Fortgeschritten · Version: 3
- C++ · Lektion 44 · Fortgeschritten · Version: 3