CKTIS / C++
std::stop_source — source de demandes d’arrêt
std::stop_source fournit un état partagé de demande d’arrêt. get_token() permet d’observer cet état, tandis que request_stop() demande l’arrêt. Il s’agit d’un mécanisme coopératif : il n’interrompt pas automatiquement un thread en cours d’exécution.
Version : C++23; repository compiler flag, production runtime not attested
Syntaxe
#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, déclaré dans l’en-tête <stop_token>, prend en charge l’arrêt coopératif. La construction par défaut crée un nouvel état sans demande d’arrêt ; les copies de la source partagent cet état. Le code qui effectue le travail doit vérifier un token ou utiliser un mécanisme qui réagit à une demande d’arrêt. La source elle-même ne démarre ni ne termine un thread.
std::stop_source::get_token() a pour signature std::stop_token get_token() const noexcept. Cette fonction renvoie un token associé à l’état de la source. Le token peut observer les demandes avec stop_requested(), mais ne peut pas demander l’arrêt. Une source construite sous la forme std::stop_source{std::nostopstate} n’a pas d’état : get_token() renvoie alors un token vide et request_stop() renvoie false.
std::stop_source::request_stop() a pour signature bool request_stop() noexcept. Cette fonction formule de manière atomique la première demande pour l’état partagé et ne renvoie true que lors de l’appel qui l’a formulée. Les appels suivants renvoient false ; cela ne signifie ni un échec ni que le travail est terminé. Une demande ne peut pas être annulée : un nouveau cycle nécessite un nouvel état.
Les fonctions de rappel enregistrées s’exécutent de manière synchrone lors de la première demande ; request_stop() peut donc exécuter du code utilisateur avant de rendre la main. Une exception qui s’échappe d’une telle fonction entraîne std::terminate. L’exemple ne crée volontairement aucun thread : il montre de façon déterministe le changement d’état observable via le token.
Exemples
#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';
}
Résultat
before: false requests: true false after: true
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.