XCEngine/docs/api/XCEngine/Threading/Thread/Thread.md

# Thread

**命名空间**: `XCEngine::Threading`

**类型**: `class`

**头文件**: `XCEngine/Threading/Thread.h`

**描述**: 对 `std::thread` 的轻量包装，附带名称字符串和一个缓存的线程标识值。

## 概述

`Thread` 不是线程系统，而是一个非常薄的 `std::thread` 外壳。它主要额外做了两件事：

- 保存一个 `Containers::String m_name`
- 在 `Start()` 时缓存一个 `m_id`

这类包装在引擎里很常见，因为很多系统希望在不直接暴露标准库类型的前提下，统一线程 API、线程名和工具层调试信息。

## 当前实现边界

- [Destructor](Destructor.md) 会在对象析构时自动 `Join()`，因此析构可能阻塞。
- [Start](Start.md) 只保存名称字符串，不会设置 OS 层面的线程名。
- [GetId](GetId.md) 的来源是 `native_handle()` 转成整数，而 [GetCurrentId](GetCurrentId.md) 的来源是 `std::thread::id` 的 hash；两者不是同一口径。
- [Start](Start.md) 当前没有防御“对一个仍然 joinable 的线程再次 Start”的情况；这会落到 `std::thread` 的终止语义。
- 当前没有对应单测覆盖。

## 公开方法

| 方法 | 说明 |
|------|------|
| [Constructor](Constructor.md) | 构造空线程对象。 |
| [Destructor](Destructor.md) | 析构时自动 join。 |
| [Start](Start.md) | 启动线程。 |
| [Join](Join.md) | 等待线程结束。 |
| [Detach](Detach.md) | 分离线程。 |
| [GetId](GetId.md) | 获取缓存的线程标识。 |
| [GetName](GetName.md) | 获取保存的线程名称。 |
| [GetCurrentId](GetCurrentId.md) | 获取当前线程标识。 |
| [Sleep](Sleep.md) | 让当前线程休眠。 |
| [Yield](Yield.md) | 让出当前线程时间片。 |

## 相关文档

- [当前模块](../Threading.md)
- [Synchronization And Task System Limits](../../../_guides/Threading/Synchronization-And-TaskSystem-Limits.md)