Files
XCEngine/docs/api/memory/proxy-allocator/proxy-allocator.md
ssdfasd 98c764bab9 docs: Fix memory module documentation discrepancies
- Add missing PoolAllocator class overview with methods table
- Add missing LinearAllocator class overview with methods table
- Add missing ProxyAllocator class overview with methods table
- Fix PoolAllocator::Allocate example code and comments
- Clarify ProxyAllocator::Free totalFreed calculation behavior
- Fix CreateLinearAllocator complexity from O(size) to O(1)
- Add note about Reallocate thread safety in ProxyAllocator
2026-03-19 00:48:44 +08:00

1.8 KiB

ProxyAllocator

命名空间: XCEngine::Memory

类型: class

描述: 代理分配器,用于统计和跟踪底层分配器的分配情况。

概述

ProxyAllocator 包装一个底层分配器,转发所有分配请求,同时记录详细的统计信息。它线程安全(使用互斥锁保护统计数据),适合需要监控内存使用的场景。

公共方法

生命周期

方法 描述
ProxyAllocator 构造代理分配器

内存操作

方法 描述
Allocate 分配内存并记录统计
Free 释放内存并记录统计
Reallocate 转发到底层分配器

统计查询

方法 描述
GetStats 获取详细统计信息

构造函数

ProxyAllocator(IAllocator* underlying, const char* name);

构造一个代理分配器,包装底层分配器并记录分配统计。所有 AllocateFreeReallocate 调用都会被转发到底层分配器,同时记录统计信息。名称用于日志和报告。

参数:

  • underlying - 被包装的底层分配器,不能为 nullptr
  • name - 代理分配器的名称字符串

返回:

复杂度: O(1)

示例:

#include <XCEngine/Memory/MemoryManager.h>
#include <XCEngine/Memory/ProxyAllocator.h>

MemoryManager::Get().Initialize();

// 使用系统分配器作为底层
IAllocator* sysAlloc = MemoryManager::Get().GetSystemAllocator();
ProxyAllocator proxy(sysAlloc, "TempAllocations");

// 通过代理分配
void* ptr = proxy.Allocate(1024);
proxy.Free(ptr);

相关文档