docs: 重构 API 文档结构并修正源码准确性
- 重组文档目录结构: 每个模块的概述页移动到模块子目录 - 重命名 index.md 为 main.md - 修正所有模块文档中的错误: - math: FromEuler→FromEulerAngles, TransformDirection 包含缩放, Box 是 OBB, Color::ToRGBA 格式 - containers: 新增 operator==/!= 文档, 补充 std::hash DJB 算法细节 - core: 修复 types 链接错误 - debug: LogLevelToString 返回大写, timestamp 是秒, Profiler 空实现标注, Windows API vs ANSI - memory: 修复头文件路径, malloc vs operator new, 新增方法文档 - resources: 修复 Shader/Texture 链接错误 - threading: TaskSystem::Wait 空实现标注, ReadWriteLock 重入描述, LambdaTask 链接 - 验证: fix_links.py 确认 0 个断裂引用
This commit is contained in:
39
docs/api/containers/hashmap/find.md
Normal file
39
docs/api/containers/hashmap/find.md
Normal file
@@ -0,0 +1,39 @@
|
||||
# HashMap::Find
|
||||
|
||||
```cpp
|
||||
Value* Find(const Key& key);
|
||||
const Value* Find(const Key& key) const;
|
||||
```
|
||||
|
||||
根据键查找对应的值指针。
|
||||
|
||||
**参数:**
|
||||
- `key` - 要查找的键
|
||||
|
||||
**返回:** 如果找到,返回指向值的指针;否则返回 `nullptr`。
|
||||
|
||||
**复杂度:** O(1) 平均,最坏 O(n)(同一桶中有多个键发生哈希冲突)
|
||||
|
||||
**示例:**
|
||||
|
||||
```cpp
|
||||
XCEngine::Containers::HashMap<int, const char*> map;
|
||||
map.Insert(1, "one");
|
||||
map.Insert(2, "two");
|
||||
|
||||
const char* value1 = map.Find(1);
|
||||
if (value1) {
|
||||
std::cout << "Found: " << value1 << std::endl; // 输出 "Found: one"
|
||||
}
|
||||
|
||||
const char* value2 = map.Find(99);
|
||||
if (!value2) {
|
||||
std::cout << "Not found" << std::endl; // 输出 "Not found"
|
||||
}
|
||||
```
|
||||
|
||||
## 相关文档
|
||||
|
||||
- [HashMap 总览](hashmap.md) - 返回类总览
|
||||
- [Contains](contains.md) - 检查是否包含键
|
||||
- [operator[]](./operator-subscript.md) - 下标访问
|
||||
Reference in New Issue
Block a user