std::jthread

在标头 <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 将从其内部的 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 对象 (公开成员函数)
(析构函数)	如果线程可合并，那么请求停止然后合并此线程。 (公开成员函数)
operator=	移动 jthread 对象 (公开成员函数)
观察器
joinable	检查线程是否可合并，即潜在运行于并行上下文之中 (公开成员函数)
get_id	返回线程的 id (公开成员函数)
native_handle	返回底层的实现定义的线程句柄 (公开成员函数)
hardware_concurrency [静态]	返回实现支持的并发线程数 (公开静态成员函数)
操作
join	等待线程完成其执行 (公开成员函数)
detach	容许线程从线程句柄独立开来执行 (公开成员函数)
swap	交换两个 jthread 对象 (公开成员函数)
停止记号处理
get_stop_source	返回与线程的共享停止状态关联的 stop_source 对象 (公开成员函数)
get_stop_token	返回与线程的共享停止状态关联的 stop_token (公开成员函数)
request_stop	经由线程的共享停止状态请求执行停止 (公开成员函数)

非成员函数

swap(std::jthread) (C++20)

特化 std::swap 算法 (函数)

注解

功能特性测试宏	值	标准	功能特性
__cpp_lib_jthread	201911L	(C++20)	停止令牌和合并线程

参阅

thread (C++11)

管理单独的线程 (类)