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

39 lines
1.1 KiB
Markdown
Raw Normal View History

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