56 lines
1.3 KiB
Markdown
56 lines
1.3 KiB
Markdown
# TaskGroup::AddTask (Callback)
|
||
|
||
```cpp
|
||
uint64_t AddTask(Callback&& func, TaskPriority priority = TaskPriority::Normal);
|
||
```
|
||
|
||
将函数回调添加为任务。该方法接受一个可调用对象（lambda、函数指针、std::function 等）作为任务执行体。
|
||
|
||
**参数：**
|
||
- `func` - 可调用对象，执行任务逻辑
|
||
- `priority` - 任务优先级，默认为 Normal
|
||
|
||
**返回：** 返回分配给任务的唯一 ID，可用于后续添加依赖关系
|
||
|
||
**线程安全：** ✅ 线程安全
|
||
|
||
**示例：**
|
||
|
||
```cpp
|
||
#include "XCEngine/Threading/TaskGroup.h"
|
||
#include "XCEngine/Threading/Task.h"
|
||
#include <iostream>
|
||
|
||
using namespace XCEngine::Threading;
|
||
|
||
int main() {
|
||
TaskGroup group;
|
||
|
||
uint64_t task1 = group.AddTask(
|
||
[]() { std::cout << "Task 1 executing\n"; },
|
||
TaskPriority::Normal
|
||
);
|
||
|
||
uint64_t task2 = group.AddTask(
|
||
[]() { std::cout << "Task 2 executing (High priority)\n"; },
|
||
TaskPriority::High
|
||
);
|
||
|
||
uint64_t task3 = group.AddTask(
|
||
[]() { std::cout << "Task 3 executing (Low priority)\n"; },
|
||
TaskPriority::Low
|
||
);
|
||
|
||
group.AddDependency(task2, task1);
|
||
|
||
group.Wait();
|
||
return 0;
|
||
}
|
||
```
|
||
|
||
## 相关文档
|
||
|
||
- [TaskGroup 总览](task-group.md) - 返回类总览
|
||
- [AddTask(ITask)](add-task.md) - 添加 ITask 对象形式的任务
|
||
- [TaskPriority](task-priority.md) - 任务优先级说明
|