Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes