CKTIS / C++
std::stop_token::stop_requested — verificar um pedido de paragem
Verifica se o estado de paragem partilhado recebeu um pedido, para poderes terminar o trabalho num ponto seguro. O resultado `true` não indica que a thread já terminou.
Versão: ISO C++23; implementation support may vary
Sintaxe
bool stop_requested() const noexcept;std::stop_token::stop_requested é uma função-membro do cabeçalho <stop_token>, introduzida em C++20 e disponível em C++23. A chamada token.stop_requested() não recebe argumentos e a função é const noexcept. Devolve true apenas se o estado de paragem associado tiver recebido um pedido de paragem. Caso contrário, devolve false, inclusive para um token construído por omissão, que não tem estado associado.
std::stop_source::get_token() devolve um token que partilha o estado de paragem da fonte, não uma cópia do valor atual do indicador. O token mantém esse estado vivo, pelo que destruir a fonte não apaga um pedido registado. token.stop_possible() responde a outra pergunta: devolve true se já tiver sido feito um pedido ou se ainda existir uma fonte associada capaz de o fazer.
std::stop_source::request_stop() emite o pedido e devolve true apenas quando regista o primeiro pedido para esse estado. Devolve false se já tiver sido pedida a paragem ou se a fonte não tiver estado. Não é possível retirar um pedido. std::jthread::request_stop() atua sobre a fonte interna do objeto std::jthread; um token obtido com get_stop_token() observa o mesmo estado.
O cancelamento é cooperativo: verifica o token entre unidades de trabalho e termina num ponto seguro. true indica um pedido, não o fim da thread. Por si só, o pedido não interrompe uma operação bloqueante arbitrária.
Exemplos
#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
O programa não inicia threads. O primeiro pedido fica registado e o segundo não altera nada. O token continua a ver o pedido após a destruição da fonte; o token vazio devolve `false`.
Lições relacionadas
- C++ · Lição 39 · Avançado · Versão: 3
- C++ · Lição 44 · Avançado · Versão: 3