36 lines
919 B
Markdown
36 lines
919 B
Markdown
# TaskSystem::DestroyTaskGroup
|
|
|
|
销毁一个由任务系统创建的任务组。
|
|
|
|
```cpp
|
|
void DestroyTaskGroup(TaskGroup* group);
|
|
```
|
|
|
|
## 行为说明
|
|
|
|
当前实现会：
|
|
|
|
1. 若 `group == nullptr`，直接返回。
|
|
2. 在 `m_groupMutex` 保护下，从 `m_taskGroups` 中查找并移除该指针。
|
|
3. 在锁外执行 `delete group`。
|
|
|
|
## 参数
|
|
|
|
- `group` - 要销毁的任务组。
|
|
|
|
## 返回值
|
|
|
|
- 无。
|
|
|
|
## 当前实现限制
|
|
|
|
- 当前不会先 [Cancel](../TaskGroup/Cancel.md) 或 [Wait](../TaskGroup/Wait.md)。
|
|
- 若任务组内部已有通过 [TaskGroup::AddTask](../TaskGroup/AddTask.md) 存进去的任务对象，`delete group` 也不会释放这些裸任务指针。
|
|
- 如果传入的指针不在 `m_taskGroups` 列表里，当前实现仍会直接 `delete group`。
|
|
|
|
## 相关文档
|
|
|
|
- [返回类型总览](TaskSystem.md)
|
|
- [CreateTaskGroup](CreateTaskGroup.md)
|
|
- [TaskGroup](../TaskGroup/TaskGroup.md)
|