CKTIS / C++
std::stop_source — fuente de solicitudes de parada
std::stop_source proporciona un estado compartido de solicitud de parada. get_token() permite observar ese estado y request_stop() solicita la parada. Es un mecanismo cooperativo: no interrumpe automáticamente un hilo en ejecución.
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 first_request = source.request_stop();
// Member signatures:
// std::stop_token get_token() const noexcept;
// bool request_stop() noexcept;std::stop_source, declarado en la cabecera <stop_token>, permite realizar paradas cooperativas. La construcción predeterminada crea un estado nuevo sin ninguna solicitud de parada; las copias de la fuente comparten ese estado. El código que realiza el trabajo debe comprobar un token o usar un mecanismo que responda a una solicitud de parada. La fuente por sí sola no inicia ni termina un hilo.
std::stop_source::get_token() tiene la firma std::stop_token get_token() const noexcept. Devuelve un token asociado al estado de la fuente; el token puede observar solicitudes mediante stop_requested(), pero no puede solicitar la parada. Una fuente construida como std::stop_source{std::nostopstate} no tiene estado: en ese caso, get_token() devuelve un token vacío y request_stop() devuelve false.
std::stop_source::request_stop() tiene la firma bool request_stop() noexcept. Solicita atómicamente la primera parada para el estado compartido y devuelve true solo en la llamada que la solicitó. Las llamadas posteriores devuelven false; esto no significa que haya habido un error ni confirma que el trabajo haya terminado. Una solicitud no se puede deshacer: un nuevo ciclo requiere un estado nuevo.
Las funciones de retorno registradas se ejecutan de forma síncrona cuando se realiza la primera solicitud, por lo que request_stop() puede ejecutar código del usuario antes de devolver el control. Si una excepción escapa de una de estas funciones, se produce std::terminate. El ejemplo no crea hilos deliberadamente: muestra de forma determinista el cambio de estado que observa el token.
Ejemplos
#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';
}
Resultado
before: false requests: true false after: 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.