CKTIS / C++
std::stop_token::stop_requested — comprobar una solicitud de detención
Comprueba si el estado de detención compartido ha recibido una solicitud para poder terminar el trabajo en un punto seguro. Un resultado `true` no indica que el hilo haya terminado.
Versión: ISO C++23; implementation support may vary
Sintaxis
bool stop_requested() const noexcept;std::stop_token::stop_requested es una función miembro de la cabecera <stop_token>, introducida en C++20 y disponible en C++23. La llamada token.stop_requested() no recibe argumentos y la función es const noexcept. Devuelve true solo si el estado de detención asociado ha recibido una solicitud de detención. En caso contrario devuelve false, también para un token construido por defecto, que no tiene estado asociado.
std::stop_source::get_token() devuelve un token que comparte el estado de detención de la fuente, no una copia del valor actual del indicador. El token mantiene vivo ese estado, así que destruir la fuente no borra una solicitud registrada. token.stop_possible() responde a otra pregunta: devuelve true si ya se ha solicitado la detención o si aún existe una fuente asociada que puede solicitarla.
std::stop_source::request_stop() emite la solicitud y devuelve true solo cuando registra la primera solicitud para ese estado. Devuelve false si ya se había solicitado la detención o si la fuente no tiene estado. No se puede retirar una solicitud. std::jthread::request_stop() actúa sobre la fuente interna del objeto std::jthread; un token obtenido con get_stop_token() observa ese mismo estado.
La cancelación es cooperativa: comprueba el token entre unidades de trabajo y termina en un punto seguro. true indica una solicitud, no que el hilo haya terminado. La solicitud por sí sola no interrumpe cualquier operación bloqueante.
Ejemplos
#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';
}
Resultado
Before request: false First request: true Repeated request: false After source destruction: true Empty token: false
El programa no inicia hilos. La primera solicitud queda registrada y la segunda no cambia nada. El token sigue viendo la solicitud tras destruirse la fuente; el token vacío devuelve `false`.
Lecciones relacionadas
- C++ · Lección 39 · Avanzado · Versión: 3
- C++ · Lección 44 · Avanzado · Versión: 3