CKTIS / C++
std::stop_source — bron van stopverzoeken
std::stop_source biedt een gedeelde toestand voor stopverzoeken. get_token() maakt het mogelijk die toestand te observeren en request_stop() vraagt om te stoppen. Dit is een coöperatief mechanisme: het onderbreekt een actieve thread niet automatisch.
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 first_request = source.request_stop();
// Member signatures:
// std::stop_token get_token() const noexcept;
// bool request_stop() noexcept;std::stop_source uit de header <stop_token> ondersteunt coöperatief stoppen. De standaardconstructie maakt een nieuwe toestand aan waarvoor geen stop is aangevraagd; kopieën van de bron delen die toestand. Code die werk uitvoert, moet een token controleren of een mechanisme gebruiken dat op een stopverzoek reageert. De bron zelf start of beëindigt geen thread.
std::stop_source::get_token() heeft de signatuur std::stop_token get_token() const noexcept. Deze functie retourneert een token dat bij de toestand van de bron hoort. Het token kan verzoeken observeren via stop_requested(), maar kan zelf geen stop aanvragen. Een bron die is geconstrueerd als std::stop_source{std::nostopstate} heeft geen toestand: get_token() retourneert dan een leeg token en request_stop() retourneert false.
std::stop_source::request_stop() heeft de signatuur bool request_stop() noexcept. De functie doet atomair het eerste verzoek voor de gedeelde toestand en retourneert alleen true bij de aanroep die het verzoek deed. Latere aanroepen retourneren false; dat betekent niet dat er iets is mislukt en bevestigt niet dat het werk is voltooid. Een verzoek kan niet ongedaan worden gemaakt: voor een nieuwe cyclus is een nieuwe toestand nodig.
Geregistreerde callbacks worden synchroon uitgevoerd wanneer het eerste verzoek wordt gedaan. Daarom kan request_stop() gebruikerscode uitvoeren voordat de functie terugkeert. Een uitzondering die uit zo’n callback ontsnapt, leidt tot std::terminate. Het voorbeeld maakt bewust geen threads aan: het toont deterministisch de toestandsverandering die via het token zichtbaar is.
Voorbeelden
#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';
}
Resultaat
before: false requests: true false after: 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.