std::stop_token

class stop_token;

Класс stop_token предоставляет возможность проверить, был ли запрошен останов или может ли он быть запрошен для связанного объекта std::stop_source. По сути, это потокобезопасное «представление» связанного состояния остановки.

Объект stop_token также можно передать конструктору std::stop_callback, чтобы вызвать функцию обратного вызова, если для связанного с stop_token объекта std::stop_source будет запрошен останов. Кроме того, stop_token можно передать функциям прерываемого ожидания из std::condition_variable_any, чтобы прервать ожидание условной переменной при запросе остановки.

Шаблоны псевдонимов-членов

Функции-члены

Функции, не являющиеся членами

Примечания

Объект stop_token обычно не создаётся независимо, а получается из std::jthread или std::stop_source. Благодаря этому он использует то же связанное состояние остановки, что и std::jthread или std::stop_source.

Пример

#include <iostream>
#include <thread>

using namespace std::literals::chrono_literals;

void f(std::stop_token stop_token, int value)
{
    while (!stop_token.stop_requested())
    {
        std::cout << value++ << ' ' << std::flush;
        std::this_thread::sleep_for(200ms);
    }
    std::cout << std::endl;
}

int main()
{
    std::jthread thread(f, 5); // prints 5 6 7 8... for approximately 3 seconds
    std::this_thread::sleep_for(3s);
    // The destructor of jthread calls request_stop() and join().
}

5 6 7 8 9 10 11 12 13 14 15 16 17 18 19