CKTIS / C++
std::stop_token — detención cooperativa de operaciones
std::stop_token permite que una operación compruebe si se ha realizado una solicitud de detención. stop_requested() lee un estado compartido; el token no detiene por sí mismo un hilo ni realiza una solicitud.
Versión: C++23; repository compiler flag, production runtime not attested
Sintaxis
#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, declarado en <stop_token>, permite detener operaciones de forma cooperativa. Un std::stop_source proporciona un token mediante get_token() y realiza una solicitud mediante request_stop(). Las copias del token comparten el estado de detención, si lo hay. El código de la operación debe responder a la solicitud por sí mismo; no se trata de una interrupción forzada del hilo.
std::stop_token::stop_requested() tiene la firma bool stop_requested() const noexcept;. Devuelve true cuando el estado asociado ha recibido una solicitud de detención y false en caso contrario. Una solicitud no se puede retirar. Obtener false no garantiza que no llegue una solicitud justo después.
stop_possible() responde a otra pregunta: devuelve false cuando el token no tiene estado, o cuando no se ha realizado ninguna solicitud y ya no queda ningún std::stop_source asociado. En los demás casos devuelve true, incluso después de una solicitud. Para un token construido por defecto, ambos métodos devuelven false.
El ejemplo no crea hilos deliberadamente, por lo que su salida es determinista. Muestra un token vacío y un token asociado antes y después de una solicitud. Esta entrada corresponde a C++23; el borrador de trabajo proporcionado es un documento en evolución, no una edición de C++23 fijada.
Ejemplos
#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';
}
Resultado
false false true false true true
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.