CKTIS / C++
std::stop_token — coöperatief stoppen van bewerkingen
Met std::stop_token kan een bewerking controleren of er een stopverzoek is gedaan. stop_requested() leest gedeelde status; de token stopt zelf geen thread en doet ook geen verzoek.
Versie: 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, gedeclareerd in <stop_token>, ondersteunt het coöperatief stoppen van bewerkingen. Een std::stop_source levert een token via get_token() en doet een verzoek via request_stop(). Kopieën van de token delen, indien aanwezig, de stopstatus. De code van de bewerking moet zelf op het verzoek reageren; dit is geen gedwongen onderbreking van een thread.
std::stop_token::stop_requested() heeft de signatuur bool stop_requested() const noexcept;. De methode retourneert true wanneer de bijbehorende status een stopverzoek heeft ontvangen, en anders false. Een verzoek kan niet worden ingetrokken. Een resultaat van false garandeert niet dat er niet direct daarna alsnog een verzoek komt.
stop_possible() beantwoordt een andere vraag: de methode retourneert false als de token geen status heeft, of als er geen verzoek is gedaan en er geen bijbehorende std::stop_source meer bestaat. In alle andere gevallen retourneert de methode true, ook na een verzoek. Voor een standaard geconstrueerde token retourneren beide methoden false.
Het voorbeeld maakt bewust geen threads aan, zodat de uitvoer deterministisch is. Het toont een lege token en een bijbehorende token vóór en na een verzoek. Dit artikel behandelt C++23; het meegeleverde werkdocument is een document in ontwikkeling, geen vastgelegde C++23-editie.
Voorbeelden
#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';
}
Resultaat
false false true false true true
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.