CKTIS / C++
std::stop_source — origem de pedidos de paragem
std::stop_source disponibiliza um estado partilhado para pedidos de paragem. get_token() permite observar esse estado e request_stop() solicita a paragem. É um mecanismo cooperativo: não interrompe automaticamente uma thread em execução.
Versão: C++23; repository compiler flag, production runtime not attested
Sintaxe
#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 no cabeçalho <stop_token>, permite uma paragem cooperativa. A construção predefinida cria um novo estado sem qualquer pedido de paragem; as cópias da origem partilham esse estado. O código que executa o trabalho tem de verificar um token ou usar um mecanismo que reaja a um pedido de paragem. A origem, por si só, não inicia nem termina uma thread.
std::stop_source::get_token() tem a assinatura std::stop_token get_token() const noexcept. Devolve um token associado ao estado da origem. O token pode observar pedidos através de stop_requested(), mas não pode solicitar a paragem. Uma origem construída como std::stop_source{std::nostopstate} não tem estado: nesse caso, get_token() devolve um token vazio e request_stop() devolve false.
std::stop_source::request_stop() tem a assinatura bool request_stop() noexcept. Efetua atomicamente o primeiro pedido para o estado partilhado e devolve true apenas na chamada que o efetuou. As chamadas seguintes devolvem false; isto não significa que tenha ocorrido uma falha nem confirma que o trabalho terminou. Um pedido não pode ser desfeito: um novo ciclo requer um novo estado.
As funções de chamada de retorno registadas são executadas de forma síncrona quando é feito o primeiro pedido, pelo que request_stop() pode executar código do utilizador antes de regressar. Uma exceção que escape de uma dessas funções causa std::terminate. O exemplo não cria threads deliberadamente: mostra de forma determinística a alteração de estado observada através do token.
Exemplos
#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
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.