C++ 参考手册
- C++11
- C++14
- C++17
- C++20
- C++ 编译器支持情况表
- 独立与宿主实现
- C++ 语言
- C++ 关键词
- 预处理器
- C++ 标准库头文件
- 具名要求
- 功能特性测试 (C++20)
- 工具库
- 类型支持（基本类型、RTTI、类型特性）
- 概念库 (C++20)
- 错误处理
- 动态内存管理
- 日期和时间工具
- 字符串库
- 容器库
- 迭代器库
- 范围库 (C++20)
- 算法库
- 数值库
- 输入/输出库
- 文件系统库
- 本地化库
- 正则表达式库
- 原子操作库
- 线程支持库
- std::thread
- std::stop_token
- std::stop_source
- std::stop_callback
- std::this_thread::get_id
- std::shared_timed_mutex
- std::shared_lock
- std::lock_guard
- std::hardware_destructive_interference_size, std::hardware_constructive_interference_size
- std::counting_semaphore, std::binary_semaphore
- std::jthread
- cpp/thread/barrier
- std::future
- std::this_thread::yield
- std::this_thread::sleep_for
- std::this_thread::sleep_until
- std::mutex
- std::recursive_mutex
- std::shared_mutex
- std::timed_mutex
- std::recursive_timed_mutex
- std::scoped_lock
- std::unique_lock
- std::defer_lock_t, std::try_to_lock_t, std::adopt_lock_t
- std::lock
- std::try_lock
- std::defer_lock, std::try_to_lock, std::adopt_lock
- std::once_flag
- std::call_once
- std::condition_variable
- std::condition_variable_any
- std::notify_all_at_thread_exit
- std::cv_status
- std::latch
- std::promise
- std::shared_future
- std::packaged_task
- std::async
- std::launch
- std::future_status
- std::future_error
- std::future_category
- std::future_errc
- 注释
- 实验性 C++ 特性
- 有用的资源
- 索引
- std 符号索引
- 协程支持 (C++20)
- C++ 关键词
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 将从其内部的 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 算法 (函数) |