Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::stop_token — arresto cooperativo delle operazioni

std::stop_token consente a un’operazione di verificare se è stata effettuata una richiesta di arresto. stop_requested() legge uno stato condiviso; il token non arresta un thread né effettua una richiesta autonomamente.

Versione: C++23; repository compiler flag, production runtime not attested

Sintassi

#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, dichiarato nell’header <stop_token>, supporta l’arresto cooperativo delle operazioni. Un std::stop_source fornisce un token tramite get_token() ed effettua una richiesta tramite request_stop(). Le copie del token condividono lo stato di arresto, se presente. Il codice dell’operazione deve reagire autonomamente alla richiesta; non si tratta di un’interruzione forzata del thread.

std::stop_token::stop_requested() ha la firma bool stop_requested() const noexcept;. Restituisce true quando lo stato associato ha ricevuto una richiesta di arresto e false altrimenti. Una richiesta non può essere ritirata. Leggere false non garantisce che una richiesta non arrivi subito dopo.

stop_possible() risponde a una domanda diversa: restituisce false se il token non ha uno stato, oppure se non è stata effettuata alcuna richiesta e non rimane alcun std::stop_source associato. Negli altri casi restituisce true, anche dopo una richiesta. Per un token costruito per default, entrambi i metodi restituiscono false.

L’esempio non crea thread di proposito, così l’output è deterministico. Mostra un token vuoto e un token associato prima e dopo una richiesta. Questa voce riguarda C++23; la bozza di lavoro fornita è un documento in evoluzione, non un’edizione C++23 congelata.

Esempi

#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';
}

Risultato

false false
true false
true true

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti