std::jthread::request_stop
来自cppreference.com
| 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 的条件变量。
示例
运行此代码
#include <chrono> #include <condition_variable> #include <iostream> #include <mutex> #include <thread> using namespace std::chrono_literals; int main() { // 嗜睡的工作线程 std::jthread sleepy_worker( [](std::stop_token stoken) { for (int i = 10; i; --i) { std::this_thread::sleep_for(300ms); if (stoken.stop_requested()) { std::cout << "嗜睡工人已被请求停止\n"; return; } std::cout << "嗜睡工人回去睡觉\n"; } }); // 等待工作线程 // 条件变量将被停止请求唤醒。 std::jthread waiting_worker( [](std::stop_token stoken) { std::mutex mutex; std::unique_lock lock(mutex); std::condition_variable_any().wait(lock, stoken, []{ return false; }); std::cout << "等待工人已被请求停止\n"; return; }); // 可以显式调用 std::jthread::request_stop(): std::cout << "请求嗜睡工人停止\n"; sleepy_worker.request_stop(); sleepy_worker.join(); std::cout << "嗜睡工人已合并\n"; // 或使用 RAII 自动调用: // waiting_worker 的析构函数会自动调用 request_stop() 并合并线程。 }
可能的输出：
请求嗜睡工人停止 嗜睡工人已被请求停止 嗜睡工人已合并 等待工人已被请求停止