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

# ProxyAllocator

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

**类型**: `class`

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

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

## 概述

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

## 公共方法

| 方法 | 描述 |
|------|------|
| [`ProxyAllocator`](constructor.md) | 构造代理分配器 |
| [`~ProxyAllocator`](~proxy-allocator.md) | 析构函数 |
| [`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) | 获取分配器名称 |

## 相关文档

- [Memory 模块总览](../memory.md) - 返回模块总览
- [IAllocator](../allocator/allocator.md) - 分配器接口
- [MemoryManager](../manager/manager.md) - 内存管理器
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			`# ProxyAllocator`

			命名空间: `XCEngine::Memory`

			类型: `class`

docs: update memory and threading API docs 2026-03-20 02:35:24 +08:00			头文件: `XCEngine/Memory/ProxyAllocator.h`

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			`描述: 代理分配器，用于统计和跟踪底层分配器的分配情况。`

			`## 概述`

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

			`## 公共方法`

			`\| 方法 \| 描述 \|`
			`\|------\|------\|`
docs: 更新 API 文档 - 多模块修复和完善 - audio: 更新 audio-system 方法文档 - components: 新增 audio-listener/audio-source 组件方法文档，新增 remove-component 方法 - core: 更新 filewriter, types 文档 - math: 更新 box 方法文档 - memory: 更新 proxy-allocator 文档 - resources: 更新 loader 和 texture 文档 - rhi: 更新 opengl 设备、shader、swap-chain 文档 - threading: 更新 mutex 和 task-system 文档 2026-03-26 01:58:45 +08:00			\| [`ProxyAllocator`](constructor.md) \| 构造代理分配器 \|
			\| [`~ProxyAllocator`](~proxy-allocator.md) \| 析构函数 \|
docs: update memory and threading API docs 2026-03-20 02:35:24 +08:00			\| [`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) \| 获取分配器名称 \|
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
docs: 重构 API 文档结构并修正源码准确性 - 重组文档目录结构: 每个模块的概述页移动到模块子目录 - 重命名 index.md 为 main.md - 修正所有模块文档中的错误: - math: FromEuler→FromEulerAngles, TransformDirection 包含缩放, Box 是 OBB, Color::ToRGBA 格式 - containers: 新增 operator==/!= 文档, 补充 std::hash DJB 算法细节 - core: 修复 types 链接错误 - debug: LogLevelToString 返回大写, timestamp 是秒, Profiler 空实现标注, Windows API vs ANSI - memory: 修复头文件路径, malloc vs operator new, 新增方法文档 - resources: 修复 Shader/Texture 链接错误 - threading: TaskSystem::Wait 空实现标注, ReadWriteLock 重入描述, LambdaTask 链接 - 验证: fix_links.py 确认 0 个断裂引用 2026-03-19 00:22:30 +08:00			`## 相关文档`

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			`- [Memory 模块总览](../memory.md) - 返回模块总览`
			`- [IAllocator](../allocator/allocator.md) - 分配器接口`
			`- [MemoryManager](../manager/manager.md) - 内存管理器`