XCEngine/docs/api/memory/allocator/allocate.md

# 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/Allocator.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) - 返回类总览