CKTIS / C++
std::stop_token::stop_requested — controleren op een stopverzoek
Controleer of de gedeelde stopstatus een verzoek heeft ontvangen, zodat je het werk op een veilig punt kunt beëindigen. `true` betekent niet dat de thread al klaar is.
Versie: ISO C++23; implementation support may vary
Syntax
bool stop_requested() const noexcept;std::stop_token::stop_requested is een lidfunctie uit <stop_token>, geïntroduceerd in C++20 en beschikbaar in C++23. De aanroep token.stop_requested() heeft geen argumenten en de functie is const noexcept. Ze geeft alleen true terug als de gekoppelde stopstatus een stopverzoek heeft ontvangen. Anders geeft ze false terug, ook voor een standaard geconstrueerd token, dat geen stopstatus heeft.
std::stop_source::get_token() geeft een token terug dat de stopstatus met de bron deelt, geen momentopname van de vlag. Het token houdt die status in leven, dus het vernietigen van de bron wist een vastgelegd verzoek niet. token.stop_possible() beantwoordt een andere vraag: het geeft true terug als er al een verzoek is gedaan of als er nog een gekoppelde bron is die een verzoek kan doen.
std::stop_source::request_stop() doet het verzoek en geeft alleen true terug als het het eerste verzoek voor die status vastlegt. Is er al een verzoek gedaan of heeft de bron geen status, dan geeft het false terug. Een verzoek kan niet worden ingetrokken. std::jthread::request_stop() werkt op de interne bron van het std::jthread-object; een token uit get_stop_token() neemt dezelfde status waar.
Annulering is coöperatief: controleer het token tussen werkeenheden en stop op een veilig punt. true meldt een verzoek, niet dat de thread klaar is. Het verzoek alleen onderbreekt geen willekeurige blokkerende bewerking.
Voorbeelden
#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';
}
Resultaat
Before request: false First request: true Repeated request: false After source destruction: true Empty token: false
Het programma start geen threads. Het eerste verzoek wordt vastgelegd en het tweede verandert niets. Het token ziet het verzoek nog nadat de bron is vernietigd; het lege token geeft `false` terug.
Gerelateerde lessen
- C++ · Les 39 · Gevorderd · Versie: 3
- C++ · Les 44 · Gevorderd · Versie: 3