Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C++

std::stop_token::stop_requested — vérifier une demande d’arrêt

Vérifiez si l’état d’arrêt partagé a reçu une demande pour terminer le travail à un point sûr. Un résultat `true` ne signifie pas que le thread est terminé.

Version : ISO C++23; implementation support may vary

Syntaxe

bool stop_requested() const noexcept;

std::stop_token::stop_requested est une fonction membre de l’en-tête <stop_token>, introduite en C++20 et disponible en C++23. L’appel token.stop_requested() ne prend aucun argument et la fonction est const noexcept. Elle renvoie true uniquement si l’état d’arrêt associé a reçu une demande d’arrêt. Sinon, elle renvoie false, notamment pour un jeton construit par défaut, qui n’a pas d’état d’arrêt.

std::stop_source::get_token() renvoie un jeton qui partage l’état d’arrêt de la source, et non une copie de la valeur du drapeau à cet instant. Le jeton maintient cet état en vie : détruire la source n’efface donc pas une demande enregistrée. token.stop_possible() répond à une autre question : il renvoie true si une demande a déjà été faite ou s’il existe encore une source associée capable d’en faire une.

std::stop_source::request_stop() émet la demande et renvoie true uniquement s’il enregistre la première demande pour cet état. Il renvoie false si une demande existe déjà ou si la source n’a pas d’état. Une demande ne peut pas être retirée. std::jthread::request_stop() agit sur la source interne de l’objet std::jthread ; un jeton obtenu par get_stop_token() observe le même état.

L’annulation est coopérative : vérifiez le jeton entre deux unités de travail et arrêtez-vous à un point sûr. Le résultat true indique une demande, pas la fin du thread. À elle seule, la demande n’interrompt pas une opération bloquante quelconque.

Exemples

#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';
}

Résultat

Before request: false
First request: true
Repeated request: false
After source destruction: true
Empty token: false

Le programme ne lance aucun thread. La première demande est enregistrée, la seconde ne change rien. Le jeton voit toujours la demande après la destruction de la source ; le jeton vide renvoie `false`.

Leçons associées

  • C++ · Leçon 39 · Avancé · Version : 3
  • C++ · Leçon 44 · Avancé · Version : 3

Sources