XCEngine/docs/api/XCEngine/Memory/PoolAllocator/Allocate.md

# PoolAllocator::Allocate

从空闲链表中取出一个固定块。

```cpp
void* Allocate(size_t size, size_t alignment = 0) override;
```

## 行为说明

当前实现按以下顺序执行：

1. 如果空闲链表为空，返回 `nullptr`。
2. 如果 `size > m_blockSize`，返回 `nullptr`。
3. 取出链表头节点，把 `m_freeBlocks` 减一。
4. 直接返回该节点地址。

需要特别注意：

- `alignment` 参数在当前实现中被完全忽略。
- 只要 `size <= m_blockSize`，调用就会占用整个 block；不会按请求大小切分。
- `size == 0` 也会消耗一个 block。
- 返回地址来自构造阶段预先切好的池，不会在调用时再次向系统堆申请内存。

## 参数

- `size` - 请求大小；必须不大于构造时的 `blockSize`。
- `alignment` - 调用期对齐要求；当前实现不使用它。

## 返回值

- `void*` - 成功时返回一个 block 的起始地址；池已耗尽或请求过大时返回 `nullptr`。

## 使用建议

- 把 `size` 理解为“上界检查”而不是“真实占用字节数”。
- 如果调用方依赖逐次调用时的不同对齐要求，当前实现并不满足这种需求。

## 相关文档

- [返回类型总览](PoolAllocator.md)
- [Free](Free.md)
- [Contains](Contains.md)