XCEngine/docs/api/memory/proxy-allocator/proxy-allocator.md

# ProxyAllocator

**命名空间**: `XCEngine::Memory`

**类型**: `class`

**头文件**: `XCEngine/Memory/ProxyAllocator.h`

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

## 概述

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

## 公共方法

| 方法 | 描述 |
|------|------|
| [`Allocate`](allocate.md) | 分配内存并记录统计 |
| [`Free`](free.md) | 释放内存并记录统计 |
| [`Reallocate`](reallocate.md) | 转发到底层分配器 |
| [`GetStats`](get-stats.md) | 获取详细统计信息 |
| [`GetTotalAllocated`](get-total-allocated.md) | 获取累计分配字节数 |
| [`GetTotalFreed`](get-total-freed.md) | 获取累计释放字节数 |
| [`GetPeakAllocated`](get-peak-allocated.md) | 获取峰值分配字节数 |
| [`GetAllocationCount`](get-allocation-count.md) | 获取分配次数 |
| [`GetName`](get-name.md) | 获取分配器名称 |

## 构造函数

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

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

**参数：**
- `underlying` - 被包装的底层分配器，不能为 `nullptr`
- `name` - 代理分配器的名称字符串

**返回：** 无

**复杂度：** O(1)

**示例：**

```cpp
#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);
```

## 相关文档

- [Memory 模块总览](../memory.md) - 返回模块总览
- [IAllocator](../allocator/allocator.md) - 分配器接口
- [MemoryManager](../manager/manager.md) - 内存管理器