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 算法 (函数) |