std::stop_source

定义于头文件 <stop_token>
class stop_source;		(C++20 起)

stop_source 类提供发出停止请求的方式，例如为了 std::jthread 取消。对一个 stop_source 对象作出的停止请求对所有拥有同一关联状态的 stop_source 与 std::stop_token 可见；调用任何对关联 std::stop_token 注册的 std::stop_callback ；并且唤醒任何在关联 std::stop_token 上等待的 std::condition_variable_any 对象。

一旦请求停止，则不能撤销。额外的停止请求无效果。

成员函数

(构造函数)	构造新的 stop_source 对象 (公开成员函数)
(析构函数)	析构 stop_source 对象 (公开成员函数)
operator=	赋值 stop_source 对象 (公开成员函数)
修改器
request_stop	对关联停止状态做出停止请求，若它存在 (公开成员函数)
swap	交换二个 stop_source 对象 (公开成员函数)
观察器
get_token	返回关联停止状态的 stop_token (公开成员函数)
stop_requested	检查是否已请求关联停止状态停止 (公开成员函数)
stop_possible	检查能否请求关联停止状态停止 (公开成员函数)

非成员函数

operator==	比较二个 std::stop_source 对象 (函数)
swap(std::stop_source) (C++20)	特化 std::swap 算法 (函数)

辅助常量

nostopstate (C++20)

用于 stop_source 构造函数的 std::nostopstate_t 实例 (常量)

辅助类

nostopstate_t (C++20)

用于 stop_source 构造函数的占位符类型 (类)

注解

为 std::jthread 取消的目的，应该用 get_stop_source() 从 std::jthread 对象取得 stop_source 对象；或者应该直接从 std::jthread 对象用 request_stop() 请求停止。然后这将使用传入 std::jthread 所调用函数（即其线程上正在执行的函数）的参数的同一关联停止状态。

然而，对于其他用途，能用默认构造函数分离构造 stop_source ，这会创建新的停止状态。

示例

本节未完成 原因：暂无示例