CKTIS / C++
std::stop_token::stop_requested — проверка за заявка за спиране
Провери дали споделеното състояние е получило заявка за спиране, за да приключиш работата в безопасен момент. Резултатът `true` не означава, че нишката вече е приключила.
Версия: ISO C++23; implementation support may vary
Синтаксис
bool stop_requested() const noexcept;std::stop_token::stop_requested е член-функция от заглавния файл <stop_token>, въведена в C++20 и налична в C++23. Извикването token.stop_requested() не приема аргументи, а функцията е const noexcept. Тя връща true само ако свързаното състояние за спиране е получило заявка за спиране. В противен случай връща false, включително за токен, създаден с конструктора по подразбиране, който няма свързано състояние.
std::stop_source::get_token() връща токен, който споделя състоянието за спиране с източника, а не копие на текущата стойност на флага. Токенът запазва състоянието, затова унищожаването на източника не изтрива записана заявка. token.stop_possible() отговаря на друг въпрос: връща true, ако вече е подадена заявка или ако все още съществува свързан източник, който може да я подаде.
std::stop_source::request_stop() подава заявката и връща true само когато записва първата заявка за това състояние. Връща false, ако вече е подадена заявка или ако източникът няма състояние. Заявката не може да бъде оттеглена. std::jthread::request_stop() действа върху вътрешния източник на обекта std::jthread; токенът от get_stop_token() наблюдава същото състояние.
Спирането е кооперативно: проверявай токена между отделни части от работата и приключи в безопасен момент. true показва заявка, а не край на нишката. Самата заявка не прекъсва произволна блокираща операция.
Примери
#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';
}
Резултат
Before request: false First request: true Repeated request: false After source destruction: true Empty token: false
Програмата не стартира нишки. Първата заявка се записва, а втората не променя нищо. Токенът вижда заявката и след унищожаването на източника; празният токен връща `false`.
Свързани уроци
- C++ · Урок 39 · Напреднало · Версия: 3
- C++ · Урок 44 · Напреднало · Версия: 3