Files
XCEngine/docs/api/memory/allocator/reallocate.md
ssdfasd a9f882f233 docs: 修正 API 文档准确性 (第二轮检查)
修复的问题:
- 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 方法空实现标注
2026-03-19 00:31:14 +08:00

56 lines
1.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# IAllocator::Reallocate
```cpp
virtual void* Reallocate(void* ptr, size_t newSize) = 0;
```
调整已分配内存块的大小。如果 `ptr``nullptr`,行为等同于 `Allocate(newSize)`。如果 `newSize` 为 0行为等同于 `Free(ptr)` 并返回 `nullptr`。如果分配器不支持重新分配,应返回 `nullptr` 并保持原内存不变。
**参数:**
- `ptr` - 指向现有内存块的指针
- `newSize` - 新的字节大小
**返回:** 调整后的新内存块指针(可能与原指针不同)
**复杂度:** 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);
}
void* Reallocate(void* ptr, size_t newSize) override {
if (newSize == 0) {
Free(ptr);
return nullptr;
}
if (!ptr) return Allocate(newSize);
size_t oldSize = /* 需要外部记录 */ 256; // 示例中硬编码
void* newPtr = Allocate(newSize);
memcpy(newPtr, ptr, oldSize < newSize ? oldSize : newSize);
Free(ptr);
return newPtr;
}
// ... 其他方法实现
};
MyAllocator alloc;
void* ptr = alloc.Allocate(128);
void* bigger = alloc.Reallocate(ptr, 256); // 扩展到 256 字节
```
## 相关文档
- [IAllocator 总览](allocator.md) - 返回类总览