std::stop_token:: stop_possible

检查 stop_token 对象是否具有关联的停止状态，且该状态要么已经收到停止请求，要么具有关联的 std::stop_source 对象。

默认构造的 stop_token 没有关联的停止状态，因此无法被停止；当关联的停止状态不存在任何 std::stop_source 对象时，若此前未发出停止请求，该状态同样无法被停止。

参数

(无)

返回值

若 stop_token 对象无关联停止状态，或尚未收到停止请求且无关联的 std::stop_source 对象，则返回 false ；否则返回 true 。

注释

如果 stop_token 对象具有关联的停止状态且已发出停止请求，此函数仍返回 true 。

如果 stop_token 对象具有来自 std::jthread 的关联停止状态——例如，该 stop_token 是通过在 std::jthread 对象上调用 get_stop_token ( ) 获取的——那么此函数始终返回 true 。 std::jthread 始终具有内部 std::stop_source 对象，即使线程的调用函数未检查该状态也是如此。

示例

#include <chrono>
#include <condition_variable>
#include <format>
#include <iostream>
#include <mutex>
#include <string_view>
#include <thread>
using namespace std::chrono_literals;
int main()
{
    std::cout << std::boolalpha;
    auto print = [](std::string_view name, const std::stop_token& token)
    {
        std::cout << std::format("{}: stop_possible = {:s}, stop_requested = {:s}\n", 
            name, token.stop_possible(), token.stop_requested()
        );
    };
    // 监听停止请求的工作线程
    auto stop_worker = std::jthread([](std::stop_token stoken)
    {
        for (int i = 10; i; --i)
        {
            std::this_thread::sleep_for(300ms);
            if (stoken.stop_requested())
            {
                std::cout << "  睡眠工作线程收到停止请求\n";
                return;
            }
            std::cout << "  睡眠工作线程继续休眠\n";
        }
    });
    // 仅在完成时停止的工作线程
    auto inf_worker = std::jthread([]()
    {
        for (int i = 5; i; --i)
        {
            std::this_thread::sleep_for(300ms);
            std::cout << "  按需运行任意时长\n";
        }
    });
    std::stop_token def_token;
    std::stop_token stop_token = stop_worker.get_stop_token();
    std::stop_token inf_token = inf_worker.get_stop_token();
    print("def_token ", def_token);
    print("stop_token", stop_token);
    print("inf_token ", inf_token);
    std::cout << "\n请求并加入stop_worker：\n";
    stop_worker.request_stop();
    stop_worker.join();
    std::cout << "\n请求并加入inf_worker：\n";
    inf_worker.request_stop();
    inf_worker.join();
    std::cout << '\n';
    print("def_token ", def_token);
    print("stop_token", stop_token);
    print("inf_token ", inf_token);
}

def_token : stop_possible = false, stop_requested = false
stop_token: stop_possible = true, stop_requested = false
inf_token : stop_possible = true, stop_requested = false
请求并加入stop_worker：
  按需运行任意时长
  睡眠工作线程收到停止请求
请求并加入inf_worker：
  按需运行任意时长
  按需运行任意时长
  按需运行任意时长
  按需运行任意时长
def_token : stop_possible = false, stop_requested = false
stop_token: stop_possible = true, stop_requested = true
inf_token : stop_possible = true, stop_requested = true