CKTIS / C++
std::stop_token — paragem cooperativa de operações
std::stop_token permite que uma operação verifique se foi feito um pedido de paragem. stop_requested() lê um estado partilhado; o token não para, por si só, uma thread nem faz um pedido.
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 requested = token.stop_requested();
// Member signature: bool stop_requested() const noexcept;std::stop_token, declarado no cabeçalho <stop_token>, permite parar operações de forma cooperativa. Um std::stop_source fornece um token através de get_token() e faz um pedido através de request_stop(). As cópias do token partilham o estado de paragem, se existir. O código da operação tem de reagir ao pedido por si próprio; não se trata de uma interrupção forçada da thread.
std::stop_token::stop_requested() tem a assinatura bool stop_requested() const noexcept;. Devolve true quando o estado associado recebeu um pedido de paragem e false caso contrário. Um pedido não pode ser retirado. Obter false não garante que não chegue um pedido logo a seguir.
stop_possible() responde a uma pergunta diferente: devolve false se o token não tiver estado, ou se não tiver sido feito qualquer pedido e já não existir nenhum std::stop_source associado. Nos restantes casos, devolve true, mesmo depois de um pedido. Para um token construído por omissão, ambos os métodos devolvem false.
O exemplo não cria threads deliberadamente, pelo que o resultado é determinístico. Mostra um token vazio e um token associado antes e depois de um pedido. Esta entrada é relativa a C++23; o projeto de norma fornecido é um documento em evolução, não uma edição C++23 fixa.
Exemplos
#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
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.