CKTIS / C++
std::stop_token — кооперативно спиране на операции
std::stop_token позволява на операция да провери дали е подадена заявка за спиране. stop_requested() прочита споделено състояние; самият токен нито спира нишка, нито подава заявка.
Версия: C++23; repository compiler flag, production runtime not attested
Синтаксис
#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 от заглавния файл <stop_token> поддържа кооперативно спиране на операции. std::stop_source предоставя токен чрез get_token() и подава заявка чрез request_stop(). Копията на токена споделят състоянието на спиране, ако има такова. Кодът на операцията трябва сам да реагира на заявката; това не е принудително прекъсване на нишка.
std::stop_token::stop_requested() има сигнатура bool stop_requested() const noexcept;. Методът връща true, когато свързаното състояние е получило заявка за спиране, и false в противен случай. Заявката не може да бъде оттеглена. Резултат false не гарантира, че заявка няма да пристигне веднага след това.
stop_possible() отговаря на друг въпрос: връща false, ако токенът няма състояние или ако не е подадена заявка и вече няма свързан std::stop_source. В останалите случаи връща true, включително след подадена заявка. При токен, създаден по подразбиране, и двата метода връщат false.
Примерът умишлено не създава нишки, така че изходът му е детерминиран. Той показва празен токен и свързан токен преди и след заявка. Тази статия е за C++23; предоставеният работен проект е документ, който продължава да се развива, а не замразено издание на C++23.
Примери
#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';
}
Резултат
false false true false true true
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.