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

# IAllocator::Free

```cpp
virtual void Free(void* ptr) = 0;
```

释放之前通过 `Allocate` 分配的内存块。如果 `ptr` 为 `nullptr`，则此调用无效果。部分分配器（如 LinearAllocator）可能不支持此操作。

**参数：**
- `ptr` - 指向要释放内存块的指针

**返回：** 无

**复杂度：** 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 {
        return ::operator new(size);
    }
    
    void Free(void* ptr) override {
        if (ptr) ::operator delete(ptr);
    }
    // ... 其他方法实现
};

MyAllocator alloc;
void* ptr = alloc.Allocate(512);
alloc.Free(ptr); // 释放内存
```

## 相关文档

- [IAllocator 总览](allocator.md) - 返回类总览