std::jthread
来自cppreference.com
| 定义于头文件 <thread>
|
||
| class jthread; |
(C++20 起) | |
类 jthread 表示单个执行线程。它拥有通常同 std::thread 的行为，除了 jthread 在析构时自动再结合，而且能在具体情况下取消/停止。
线程在构造关联的线程对象时（在任何操作系统调度延迟后）立即开始执行，始于作为构造函数参数提供的顶层函数。忽略顶层函数的返回值，而若它因抛异常退出，则调用 std::terminate 。顶层函数可经由 std::promise 向调用方交流其返回值或异常，或通过修改共享变量（要求同步，见 std::mutex 与 std::atomic ）。
不同于 std::thread ， jthread 逻辑上保有一个内部的 std::stop_source 类型私有成员，它维持共享停止状态。 jthread 的构造函数接受一个 std::stop_token 作为其首参数， jthread 将从其内部的 stop_source 传递它。这允许函数在其执行中检查是否已请求停止，而若已请求则返回。
std::jthread 对象亦可在不表示任何线程的状态（在默认构造、被移动、 detach 或 join 后），而执行线程可以与任何 jthread 对象关联（ detach 后）。
没有二个 std::jthread 对象可表示同一执行线程； std::jthread 非可复制构造 (CopyConstructible) 或可复制赋值 (CopyAssignable) ，尽管它为可移动构造 (MoveConstructible) 及可移动赋值 (MoveAssignable) 。
成员类型
| 成员类型 | 定义 |
id
|
std::thread::id |
native_handle_type (可选)
|
std::thread::native_handle_type |
成员函数
创建新的 jthread 对象 (公开成员函数) | |
若 joinable() 为 true ，则调用 request_stop() 然后 join() ；不论如何都会销毁 jthread 对象。 (公开成员函数) | |
移动 jthread 对象 (公开成员函数) | |
观察器 | |
| 检查线程是否可合并，即潜在地运行于平行环境中 (公开成员函数) | |
| 返回线程的 id (公开成员函数) | |
| 返回底层实现定义的线程句柄 (公开成员函数) | |
| 返回实现支持的并发线程数 (公开静态成员函数) | |
操作 | |
| 等待线程完成其执行 (公开成员函数) | |
| 容许线程从线程句柄独立开来执行 (公开成员函数) | |
交换二个 jthread 对象 (公开成员函数) | |
停止记号处理 | |
返回与线程的停止状态关联的 stop_source 对象 (公开成员函数) | |
返回与线程的共享停止状态关联的 stop_token (公开成员函数) | |
| 请求执行经由线程的共享停止状态停止 (公开成员函数) | |
非成员函数
| (C++20) |
特化 std::swap 算法 (函数) |