std::stop_source
来自cppreference.com
定义于头文件 <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 对象 (公开成员函数) | |
赋值 stop_source 对象 (公开成员函数) | |
修改器 | |
对关联停止状态做出停止请求,若它存在 (公开成员函数) | |
交换二个 stop_source 对象 (公开成员函数) | |
观察器 | |
返回关联停止状态的 stop_token (公开成员函数) | |
检查是否已请求关联停止状态停止 (公开成员函数) | |
检查能否请求关联停止状态停止 (公开成员函数) |
非成员函数
比较二个 std::stop_source 对象 (函数) | |
(C++20) |
特化 std::swap 算法 (函数) |
辅助常量
(C++20) |
用于 stop_source 构造函数的 std::nostopstate_t 实例 (常量) |
辅助类
(C++20) |
用于 stop_source 构造函数的占位符类型 (类) |
注解
为 std::jthread
取消的目的,应该用 get_stop_source() 从 std::jthread
对象取得 stop_source
对象;或者应该直接从 std::jthread
对象用 request_stop() 请求停止。然后这将使用传入 std::jthread
所调用函数(即其线程上正在执行的函数)的参数的同一关联停止状态。
然而,对于其他用途,能用默认构造函数分离构造 stop_source
,这会创建新的停止状态。
示例
本节未完成 原因:暂无示例 |