38 lines
871 B
Markdown
38 lines
871 B
Markdown
# GameObject::Find
|
||
|
||
按对象名称在全局 registry 中查找第一个匹配的 `GameObject`。
|
||
|
||
```cpp
|
||
static GameObject* Find(const std::string& name);
|
||
```
|
||
|
||
## 行为说明
|
||
|
||
当前实现会遍历 `GameObject::GetGlobalRegistry()`，并检查：
|
||
|
||
```cpp
|
||
pair.second->GetName() == name
|
||
```
|
||
|
||
找到第一个匹配项后立即返回。
|
||
|
||
## 重要边界
|
||
|
||
- 查询范围是全局 registry，不是某个 `Scene` 的局部子树
|
||
- 独立构造、未加入场景的对象默认不会被查到
|
||
- registry 底层是 `std::unordered_map`，因此“第一个匹配项”的顺序不构成稳定契约
|
||
|
||
## 参数
|
||
|
||
- `name` - 目标对象名。
|
||
|
||
## 返回值
|
||
|
||
- `GameObject*` - 找到时返回匹配对象；否则返回 `nullptr`。
|
||
|
||
## 相关文档
|
||
|
||
- [GameObject](GameObject.md)
|
||
- [FindObjectsOfType](FindObjectsOfType.md)
|
||
- [FindGameObjectsWithTag](FindGameObjectsWithTag.md)
|