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

CKTIS / C++

std::stop_source — източник на заявки за спиране

std::stop_source предоставя споделено състояние за заявка за спиране. get_token() позволява това състояние да се наблюдава, а request_stop() заявява спиране. Това е кооперативен механизъм: не прекъсва автоматично изпълняваща се нишка.

Версия: C++23; repository compiler flag, production runtime not attested

Синтаксис

#include <stop_token>

std::stop_source source;
std::stop_token token = source.get_token();
bool first_request = source.request_stop();

// Member signatures:
// std::stop_token get_token() const noexcept;
// bool request_stop() noexcept;

std::stop_source от заглавния файл <stop_token> поддържа кооперативно спиране. Конструкцията по подразбиране създава ново състояние, за което не е заявено спиране; копията на източника споделят това състояние. Кодът, който извършва работата, трябва да проверява токен или да използва механизъм, който реагира на заявка за спиране. Самият източник нито стартира, нито прекратява нишка.

std::stop_source::get_token() има сигнатура std::stop_token get_token() const noexcept. Тя връща токен, свързан със състоянието на източника. Токенът може да наблюдава заявки чрез stop_requested(), но не може да заяви спиране. Източник, конструиран като std::stop_source{std::nostopstate}, няма състояние: тогава get_token() връща празен токен, а request_stop() връща false.

std::stop_source::request_stop() има сигнатура bool request_stop() noexcept. Тя атомарно подава първата заявка за споделеното състояние и връща true само при извикването, което я е подало. Следващите извиквания връщат false; това не означава грешка и не потвърждава, че работата е приключила. Заявката не може да бъде отменена: за нов цикъл е необходимо ново състояние.

Регистрираните обратни извиквания се изпълняват синхронно при първата заявка, затова request_stop() може да изпълни потребителски код, преди да се върне. Изключение, което излезе от такова извикване, води до std::terminate. Примерът умишлено не създава нишки: той показва детерминистично промяната в състоянието, наблюдавана чрез токена.

Примери

#include <iostream>
#include <stop_token>

int main() {
    std::stop_source source;
    const std::stop_token token = source.get_token();

    std::cout << std::boolalpha;
    std::cout << "before: " << token.stop_requested() << '\n';

    const bool first = source.request_stop();
    const bool second = source.request_stop();

    std::cout << "requests: " << first << ' ' << second << '\n';
    std::cout << "after: " << token.stop_requested() << '\n';
}

Резултат

before: false
requests: true false
after: true

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници