Files
XCEngine/docs/api/memory/pool-allocator/allocate.md
ssdfasd 82cf147817 docs: 修正 API 文档准确性 (第四轮检查)
修复问题:
- containers: HashMap 实现描述修正
- debug: XE_LOG 宏参数顺序修正
- memory: ProxyAllocator 统计示例修正, PoolAllocator allocate size 检查描述
- resources: ResourceManager 缺失 UnloadGroup 方法
- rhi: D3D12 格式枚举名称修正, Texture Format 枚举补全, ResourceStates 补充
- threading: TaskGroup GetProgress/Wait/Cancel 实现限制说明
2026-03-19 00:43:16 +08:00

38 lines
1014 B
Markdown

# PoolAllocator::Allocate
```cpp
void* Allocate(size_t size, size_t alignment = 0) override;
```
从内存池中分配一个空闲块。每次分配一个固定大小的块。如果 `size` 超过块大小或池中没有空闲块,返回 `nullptr`。分配操作从空闲链表头部取出一个块。
**参数:**
- `size` - 请求的大小,如果超过构造时指定的块大小则分配失败
- `alignment` - 被忽略(构造时确定)
**返回:** 分配成功返回块指针,池空返回 `nullptr`
**复杂度:** O(1)
**示例:**
```cpp
#include <XCEngine/Memory/PoolAllocator.h>
PoolAllocator pool(sizeof(int) * 100, 50, alignof(int));
// 分配(忽略 size 参数)
void* block1 = pool.Allocate(1); // 分配 1 字节
void* block2 = pool.Allocate(10000); // 也分配一块
if (block1 && block2) {
// 使用分配的内存块
int* arr = static_cast<int*>(block1);
arr[0] = 42;
}
```
## 相关文档
- [PoolAllocator 总览](pool-allocator.md) - 返回类总览