std::jthread::request_stop

来自cppreference.com
< cpp‎ | thread‎ | jthread
 
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++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++11)
信号量
(C++20)(C++20)
闩与屏障
(C++20)
(C++20)
future
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
 
std::jthread
 
bool request_stop() noexcept;
 (C++20 起)

若内部停止状态尚未被请求停止，则对它发出停止请求。

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

  • 能在同一共享状态的 std::stop_token 与 std::stop_source 上同时调用 stop_requested() 与 stop_possible()
  • 能从多个线程在同一 jthread 对象或与同一停止状态关联的其他 std::stop_source 对象上并发调用 request_stop() ，而将只有一个线程实际进行停止请求

然而，见注解节。

参数

（无）

返回值

若调用做出停止请求则为 true ，否则为 false 。

后条件

对于由 get_stop_token() 取得的 std::stop_token 或由 get_stop_source() 取得的 std::stop_source ， stop_requested() 为 true 。

注解

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

若已作出停止请求，则此函数返回 false 。然而不保证正好对同一停止状态（成功）请求停止的另一线程或 std::stop_source 对象不仍然在调用 std::stop_callback 函数的中间。

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

示例

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