修复的问题: - math: 修复 Quaternion::Normalize 链接错误 - containers: HashMap 迭代器示例使用不存在的 cbegin/cend,删除冗余构造函数声明 - core: RefCounted 析构函数访问级别修正 (protected) - debug: LogLevelToString 示例返回值大小写修正 - memory: 修正 LinearAllocator::Reallocate 返回 nullptr,ProxyAllocator 统计描述,头文件路径 IAllocator.h -> Allocator.h - resources: Texture::Create mipLevels 参数描述修正 - rhi: 修复多处链接错误,新增缺失的方法文档 - threading: TaskSystem 配置项未实现状态标注,Wait 方法空实现标注
42 lines
1.2 KiB
Markdown
42 lines
1.2 KiB
Markdown
# ProxyAllocator::Free
|
|
|
|
```cpp
|
|
void Free(void* ptr) override;
|
|
```
|
|
|
|
释放内存并记录统计。调用转发到底层分配器,同时更新统计信息:递增 `totalFreed`(累加当前分配计数),并递减 `allocationCount`。由于 ProxyAllocator 不记录单独释放的字节数,`totalFreed` 累加的是 `allocationCount` 而非实际字节大小。
|
|
|
|
**参数:**
|
|
- `ptr` - 指向要释放的内存块
|
|
|
|
**返回:** 无
|
|
|
|
**复杂度:** O(1)(底层释放 + 统计更新)
|
|
|
|
**示例:**
|
|
|
|
```cpp
|
|
#include <XCEngine/Memory/MemoryManager.h>
|
|
#include <XCEngine/Memory/ProxyAllocator.h>
|
|
|
|
IAllocator* sysAlloc = MemoryManager::Get().GetSystemAllocator();
|
|
ProxyAllocator proxy(sysAlloc, "TrackedAlloc");
|
|
|
|
void* p1 = proxy.Allocate(512);
|
|
void* p2 = proxy.Allocate(256);
|
|
|
|
proxy.Free(p1);
|
|
proxy.Free(p2);
|
|
|
|
const auto& stats = proxy.GetStats();
|
|
// totalFreed 累加了每次释放时的 allocationCount
|
|
// allocationCount 最终为 0
|
|
printf("Total allocated: %zu, Total freed: %zu, Current: %zu\n",
|
|
stats.totalAllocated, stats.totalFreed,
|
|
stats.totalAllocated - stats.totalFreed);
|
|
```
|
|
|
|
## 相关文档
|
|
|
|
- [ProxyAllocator 总览](proxy-allocator.md) - 返回类总览
|