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> usingnamespace std::chrono_literals; // 用于简便展示哪个线程打印了什么内容的辅助函数void print(auto txt){std::cout<<std::this_thread::get_id()<<' '<< txt;} 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()){ print("嗜睡工人已被请求停止\n");return;} print("嗜睡工人回去睡觉\n");}}); // 等待工作线程// 条件变量将被停止请求唤醒。std::jthread waiting_worker([](std::stop_token stoken){std::mutex mutex;std::unique_lock lock(mutex);std::condition_variable_any().wait(lock, stoken, []{returnfalse;}); print("等待工人已被请求停止\n");return;}); // 此线程睡眠，让其他线程有时间互旋std::this_thread::sleep_for(400ms); // 可以显式调用 std::jthread::request_stop(): print("请求嗜睡工人停止\n"); sleepy_worker.request_stop(); sleepy_worker.join(); print("嗜睡工人已合并\n"); // 或使用 RAII 自动调用:// waiting_worker 的析构函数会自动调用 request_stop() 并合并线程。}
可能的输出：
140287602706176 嗜睡工人回去睡觉 140287623300928 请求嗜睡工人停止 140287602706176 嗜睡工人已被请求停止 140287623300928 嗜睡工人已合并 140287594313472 等待工人已被请求停止
