CKTIS / C++
std::stop_token — arrêt coopératif des opérations
std::stop_token permet à une opération de vérifier si une demande d’arrêt a été faite. La méthode stop_requested() lit un état partagé ; le jeton ne met pas lui-même fin à un thread et ne formule aucune demande.
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 requested = token.stop_requested();
// Member signature: bool stop_requested() const noexcept;std::stop_token, déclaré dans l’en-tête <stop_token>, permet l’arrêt coopératif des opérations. Un std::stop_source fournit un jeton avec get_token() et formule une demande avec request_stop(). Les copies du jeton partagent le même état d’arrêt, s’il existe. Le code de l’opération doit réagir lui-même à la demande ; il ne s’agit pas d’une interruption forcée du thread.
std::stop_token::stop_requested() a pour signature bool stop_requested() const noexcept;. La méthode renvoie true lorsque l’état associé a reçu une demande d’arrêt, et false dans le cas contraire. Une demande ne peut pas être retirée. Lire false ne garantit pas qu’aucune demande ne sera faite juste après.
stop_possible() répond à une autre question : la méthode renvoie false si le jeton n’a pas d’état, ou si aucune demande n’a été faite et qu’il ne reste aucune std::stop_source associée. Dans les autres cas, elle renvoie true, y compris après une demande. Pour un jeton construit par défaut, les deux méthodes renvoient false.
L’exemple ne crée volontairement aucun thread, ce qui rend sa sortie déterministe. Il montre un jeton vide et un jeton associé avant et après une demande. Cette entrée porte sur C++23 ; le projet de norme fourni est un document évolutif, et non une édition C++23 figée.
Exemples
#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';
}
Résultat
false false true false true 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.