CKTIS / C++
std::stop_token::stop_requested — verificare una richiesta di arresto
Verifica se lo stato di arresto condiviso ha ricevuto una richiesta, così da poter terminare il lavoro in un punto sicuro. `true` non indica che il thread sia già terminato.
Versione: ISO C++23; implementation support may vary
Sintassi
bool stop_requested() const noexcept;std::stop_token::stop_requested è una funzione membro dell’header <stop_token>, introdotta in C++20 e disponibile in C++23. La chiamata token.stop_requested() non richiede argomenti e la funzione è const noexcept. Restituisce true solo se lo stato di arresto associato ha ricevuto una richiesta di arresto. Altrimenti restituisce false, anche per un token costruito per default, che non ha uno stato associato.
std::stop_source::get_token() restituisce un token che condivide lo stato di arresto della sorgente, non una copia del valore corrente del flag. Il token mantiene in vita quello stato, quindi distruggere la sorgente non cancella una richiesta registrata. token.stop_possible() risponde a una domanda diversa: restituisce true se è già stata fatta una richiesta o se esiste ancora una sorgente associata in grado di farla.
std::stop_source::request_stop() invia la richiesta e restituisce true solo quando registra la prima richiesta per quello stato. Restituisce false se la richiesta era già stata fatta o se la sorgente non ha uno stato. Una richiesta non può essere revocata. std::jthread::request_stop() agisce sulla sorgente interna dell’oggetto std::jthread; un token ottenuto da get_stop_token() osserva lo stesso stato.
L’annullamento è cooperativo: controlla il token tra un’unità di lavoro e l’altra e fermati in un punto sicuro. true segnala una richiesta, non la conclusione del thread. La richiesta da sola non interrompe un’operazione bloccante arbitraria.
Esempi
#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';
}
Risultato
Before request: false First request: true Repeated request: false After source destruction: true Empty token: false
Il programma non avvia thread. La prima richiesta viene registrata e la seconda non cambia nulla. Il token vede ancora la richiesta dopo la distruzione della sorgente; il token vuoto restituisce `false`.
Lezioni correlate
- C++ · Lezione 39 · Avanzato · Versione: 3
- C++ · Lezione 44 · Avanzato · Versione: 3