std::stop_source::request_stop

来自cppreference.com
< cpp‎ | thread‎ | stop source
 
C++
 
并发支持库
线程
(C++11)
(C++20)
(C++20)
(C++20)
(C++20)
(C++17)(C++17)
this_thread 命名空间
(C++11)
(C++11)
(C++11)
(C++11)
互斥
(C++11)
(C++11)  
(C++17)
通用锁管理
(C++11)
(C++11)
(C++17)
(C++11)
(C++14)
(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)
闩与屏障
(C++20)
(C++20)
未来体
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
安全回收
(C++26)
(C++26)
(C++26)  
(C++26)
(C++26)
(C++26)
风险指针
(C++26)
(C++26)
(C++26)





原子类型
(C++11)
(C++20)
(C++11)
原子类型的初始化
(C++11)(C++20 中弃用)
(C++11)(C++20 中弃用)
(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++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)
(C++26)(C++26)
(C++26)(C++26)
(C++11)
(C++20)(C++20)
(C++20)
(C++20)
原子标志的自由函数
(C++11)(C++11)
(C++11)(C++11)
(C++20)(C++20)
(C++20)(C++20)
(C++20)
(C++20)
 
std::stop_source
 
bool request_stop() noexcept;
 (C++20 起)

若 stop_source 对象拥有停止状态且未被请求停止，则发出停止请求给停止状态。

原子地作出确定，而若请求了停止，则原子地更新停止状态以避免竞争条件，使得：

  • 能在同一共享状态的其他 std::stop_token 与 std::stop_source 上并发调用 stop_requested() 与 stop_possible()；
  • 能在其他 std::stop_source 对象上并发调用 request_stop()，而将只有一个实际进行停止请求。

然而，见注解节。

参数

（无）

返回值

若 stop_source 对象拥有停止状态且此调用做出了停止请求则为 true，否则为 false。

后条件

stop_possible() 为 false 或 stop_requested() 为 true。

注解

若 request_stop() 确实发出了停止请求（即返回 true），则将在发出 request_stop() 的同一线程上同步调用对同一共享停止状态注册的所有 std::stop_callback。若有任何回调的调用经由异常退出，则调用 std::terminate。

若此 stop_source 对象拥有停止状态但已作出停止请求，则此函数返回 false。然而不保证正好对同一停止状态（成功）请求停止的另一 stop_source 不会仍然处于调用某个 std::stop_callback 函数过程中。

若 request_stop() 确实发出了停止请求（即返回 true），则提醒用与 stop_source 的停止状态关联的 stop_token 的可中断等待注册的、基类型为 std::condition_variable_any 的所有条件变量。

示例

本节未完成
原因：暂无示例
来自“https://zh.cppreference.com/mwiki/index.php?title=cpp/thread/stop_source/request_stop&oldid=88897”