std::stop_source

来自cppreference.com
< cpp‎ | thread
 
 
线程支持库
线程
(C++11)
(C++20)
(C++20)
stop_source
(C++20)
this_thread 命名空间
(C++11)
(C++11)
(C++11)
互斥
(C++11)
通用锁管理
(C++11)
(C++11)
(C++11)
(C++11)(C++11)(C++11)
(C++11)
(C++11)
条件变量
(C++11)
信号量
闩与屏障
(C++20)
(C++20)
future
(C++11)
(C++11)
(C++11)
(C++11)
 
 
定义于头文件 <stop_token>
class stop_source;
(C++20 起)

stop_source 类提供发出停止请求的方式,例如为了 std::jthread 取消。对一个 stop_source 对象作出的停止请求对所有拥有同一关联状态的 stop_sourcestd::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 对象
(函数)
特化 std::swap 算法
(函数)

辅助常量

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

辅助类

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

注解

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

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

示例