- 重组文档目录结构: 每个模块的概述页移动到模块子目录 - 重命名 index.md 为 main.md - 修正所有模块文档中的错误: - math: FromEuler→FromEulerAngles, TransformDirection 包含缩放, Box 是 OBB, Color::ToRGBA 格式 - containers: 新增 operator==/!= 文档, 补充 std::hash DJB 算法细节 - core: 修复 types 链接错误 - debug: LogLevelToString 返回大写, timestamp 是秒, Profiler 空实现标注, Windows API vs ANSI - memory: 修复头文件路径, malloc vs operator new, 新增方法文档 - resources: 修复 Shader/Texture 链接错误 - threading: TaskSystem::Wait 空实现标注, ReadWriteLock 重入描述, LambdaTask 链接 - 验证: fix_links.py 确认 0 个断裂引用
1.7 KiB
1.7 KiB
Thread
命名空间: XCEngine::Threading
类型: class
头文件: XCEngine/Threading/Thread.h
描述: 线程封装类,提供跨平台线程创建和管理功能。
概述
Thread 类封装了 std::thread,提供统一的线程管理接口,包括启动、加入、分离等操作。
公共类型
| 类型 | 描述 |
|---|---|
using Id = uint64_t |
线程唯一标识符类型 |
公共方法
生命周期
| 方法 | 描述 |
|---|---|
Thread() |
默认构造函数 |
~Thread() |
析构函数 |
线程控制
| 方法 | 描述 |
|---|---|
Start |
启动线程,执行传入的函数 |
Join |
等待线程结束 |
Detach |
分离线程,使其独立运行 |
属性访问
| 方法 | 描述 |
|---|---|
GetId |
获取线程 ID |
GetName |
获取线程名称 |
静态方法
| 方法 | 描述 |
|---|---|
GetCurrentId |
获取当前线程 ID |
Sleep |
线程休眠指定毫秒数 |
Yield |
让出当前线程的时间片 |
使用示例
#include <XCEngine/Threading/Thread.h>
// 创建并启动线程
Thread thread;
thread.Start([]() {
printf("Worker thread running\n");
}, "WorkerThread");
// 等待线程结束
thread.Join();
// 使用静态方法
Thread::Sleep(1000); // 休眠1秒
Thread::Yield(); // 让出时间片
auto currentId = Thread::GetCurrentId();
相关文档
- Mutex - 互斥锁
- TaskSystem - 任务调度系统
- ../threading/threading.md - 模块总览