# TaskSystem::RunOnMainThread

把一个回调排入主线程执行队列。

```cpp
void RunOnMainThread(std::function<void()>&& func);
```

## 行为说明

当前实现会在 `m_queueMutex` 保护下把回调追加到 `m_mainThreadQueue`。

这些回调不会立即执行，而是等待 [Update](Update.md) 被调用时再统一消费。

## 参数

- `func` - 需要在主线程执行的回调。

## 返回值

- 无。

## 注意事项

- 当前实现本身不检查调用线程是否为主线程；“主线程”只是通过谁来调用 [Update](Update.md) 约定出来的。
- 当前没有队列容量限制，也没有通知等待主线程的机制。

## 相关文档

- [返回类型总览](TaskSystem.md)
- [Update](Update.md)