std::jthread
来自 cppreference.cn
| 定义于头文件 <thread> |
||
| class jthread; |
(since 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 从其内部 std::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 对象(公有成员函数) | |
| 如果线程是可连接的，则请求停止并连接线程 (公有成员函数) | |
移动 jthread 对象(公有成员函数) | |
观察器 | |
| 检查线程是否是可连接的，即可能在并行上下文中运行 (公有成员函数) | |
| 返回线程的 id (公有成员函数) | |
| 返回底层实现定义的线程句柄 (公有成员函数) | |
| 返回实现支持的并发线程数 (公有静态成员函数) | |
操作 | |
| 等待线程完成其执行 (公有成员函数) | |
| 允许线程独立于线程句柄执行 (公有成员函数) | |
| 交换两个 jthread 对象 (公有成员函数) | |
停止令牌处理 | |
返回与线程的共享停止状态关联的 stop_source 对象(公有成员函数) | |
返回与线程的共享停止状态关联的 stop_token(公有成员函数) | |
| 通过线程的共享停止状态请求执行停止 (公有成员函数) | |
[编辑] 非成员函数
| (C++20) |
特化 std::swap 算法 (函数) |
[编辑] 注解
| 特性测试 宏 | 值 | Std | 特性 |
|---|---|---|---|
__cpp_lib_jthread |
201911L |
(C++20) | 停止令牌 和 连接线程 |
[编辑] 参见
| (C++11) |
管理一个独立的线程 (类) |
