CKTIS / C++
std::stop_token — kooperativno zaustavljanje operacija
std::stop_token omogućuje operaciji da provjeri je li upućen zahtjev za zaustavljanje. stop_requested() čita zajedničko stanje; sam token ne zaustavlja dretvu niti upućuje zahtjev.
Verzija: C++23; repository compiler flag, production runtime not attested
Sintaksa
#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 iz zaglavlja <stop_token> podržava kooperativno zaustavljanje operacija. std::stop_source pruža token putem get_token() i upućuje zahtjev putem request_stop(). Kopije tokena dijele stanje zaustavljanja, ako ono postoji. Kod operacije mora sam reagirati na zahtjev; ne radi se o prisilnom prekidu dretve.
std::stop_token::stop_requested() ima potpis bool stop_requested() const noexcept;. Vraća true kada povezano stanje primi zahtjev za zaustavljanje, a inače false. Zahtjev se ne može povući. Vrijednost false ne jamči da zahtjev neće stići odmah nakon toga.
stop_possible() odgovara na drugo pitanje: vraća false ako token nema stanje ili ako nije upućen nijedan zahtjev i više ne postoji povezani std::stop_source. U ostalim slučajevima vraća true, čak i nakon upućenog zahtjeva. Za token stvoren prema zadanim postavkama obje metode vraćaju false.
Primjer namjerno ne stvara dretve, pa je njegov izlaz deterministički. Prikazuje prazan token i povezani token prije zahtjeva i nakon njega. Ovaj se unos odnosi na C++23; priloženi radni nacrt dokument je koji se dalje razvija, a ne zamrznuto izdanje C++23.
Primjeri
#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';
}
Rezultat
false false true false true true
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.