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.