Files
XCEngine/docs/api/memory/allocator/allocate.md
ssdfasd dc850d7739 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 个断裂引用
2026-03-19 00:22:30 +08:00

39 lines
1.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# IAllocator::Allocate
```cpp
virtual void* Allocate(size_t size, size_t alignment = 0) = 0;
```
从分配器请求指定大小的内存块。如果 `alignment` 大于 0则返回的地址将按该对齐值对齐。分配成功时返回有效指针失败时返回 `nullptr` 或抛出异常(取决于具体实现)。
**参数:**
- `size` - 请求的字节数
- `alignment` - 内存对齐要求,默认为 0表示使用实现默认对齐
**返回:** 分配成功返回已分配内存块的指针,失败返回 `nullptr`
**复杂度:** O(1)(固定块分配器)或 O(n)(需要搜索合适大小的块)
**示例:**
```cpp
#include <XCEngine/Memory/IAllocator.h>
class MyAllocator : public IAllocator {
public:
void* Allocate(size_t size, size_t alignment = 0) override {
// 使用系统 new 分配
return ::operator new(size);
}
// ... 其他方法实现
};
MyAllocator alloc;
void* ptr = alloc.Allocate(256); // 分配 256 字节
void* aligned = alloc.Allocate(64, 16); // 分配 64 字节16 字节对齐
```
## 相关文档
- [IAllocator 总览](allocator.md) - 返回类总览