91 lines
2.2 KiB
Markdown
91 lines
2.2 KiB
Markdown
# TaskGroup::AddDependency
|
||
|
||
```cpp
|
||
void AddDependency(uint64_t taskId, uint64_t dependsOn);
|
||
```
|
||
|
||
为任务添加依赖关系。指定的任务 `taskId` 将在 `dependsOn` 任务完成后才会开始执行。
|
||
|
||
**参数：**
|
||
- `taskId` - 从属任务的 ID
|
||
- `dependsOn` - 被依赖任务的 ID，taskId 将在此任务完成后才执行
|
||
|
||
**返回：** 无
|
||
|
||
**线程安全：** ✅ 线程安全
|
||
|
||
**示例：**
|
||
|
||
```cpp
|
||
#include "XCEngine/Threading/TaskGroup.h"
|
||
#include "XCEngine/Threading/Task.h"
|
||
#include <iostream>
|
||
#include <memory>
|
||
|
||
using namespace XCEngine::Threading;
|
||
|
||
int main() {
|
||
TaskGroup group;
|
||
|
||
uint64_t loadData = group.AddTask(
|
||
[]() { std::cout << "Loading data...\n"; },
|
||
TaskPriority::High
|
||
);
|
||
|
||
uint64_t processData = group.AddTask(
|
||
[]() { std::cout << "Processing data...\n"; },
|
||
TaskPriority::Normal
|
||
);
|
||
|
||
uint64_t saveData = group.AddTask(
|
||
[]() { std::cout << "Saving data...\n"; },
|
||
TaskPriority::Low
|
||
);
|
||
|
||
group.AddDependency(processData, loadData);
|
||
group.AddDependency(saveData, processData);
|
||
|
||
std::cout << "Execution order: loadData -> processData -> saveData\n";
|
||
|
||
group.Wait();
|
||
return 0;
|
||
}
|
||
```
|
||
|
||
## 相关文档
|
||
|
||
- [TaskGroup 总览](task-group.md) - 返回类总览
|
||
|
||
## 详细描述
|
||
|
||
`AddDependency` 方法用于设置任务间的依赖关系。`taskId` 指定的任务将等待 `dependsOn` 指定的任务完成后才能开始执行。
|
||
|
||
依赖关系必须在任务执行前设置，建议在所有任务添加完成后统一设置依赖。
|
||
|
||
## 参数
|
||
|
||
| 参数 | 类型 | 描述 |
|
||
|------|------|------|
|
||
| `taskId` | `uint64_t` | 依赖其他任务的任务ID |
|
||
| `dependsOn` | `uint64_t` | 被依赖的任务ID |
|
||
|
||
## 返回值
|
||
|
||
无
|
||
|
||
## 示例
|
||
|
||
```cpp
|
||
TaskGroup* group = TaskSystem::Get().CreateTaskGroup();
|
||
|
||
uint64_t loadData = group->AddTask([]() { /* 加载数据 */ });
|
||
uint64_t processData = group->AddTask([]() { /* 处理数据 */ });
|
||
uint64_t saveData = group->AddTask([]() { /* 保存数据 */ });
|
||
|
||
// processData必须在loadData完成后才能执行
|
||
group->AddDependency(processData, loadData);
|
||
|
||
// saveData必须在processData完成后才能执行
|
||
group->AddDependency(saveData, processData);
|
||
```
|