База знанияИзпитен център
BGБългарски
Избери език13

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

Източници