Files

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

1.5 KiB

Raw Blame History

IAllocator::Reallocate

virtual void* Reallocate(void* ptr, size_t newSize) = 0;

调整已分配内存块的大小。如果 ptr 为 nullptr，行为等同于 Allocate(newSize)。如果 newSize 为 0，行为等同于 Free(ptr) 并返回 nullptr。如果分配器不支持重新分配，应返回 nullptr 并保持原内存不变。

参数：

ptr - 指向现有内存块的指针
newSize - 新的字节大小

返回： 调整后的新内存块指针（可能与原指针不同）

复杂度： O(n)，需要分配新内存并复制数据

示例：

#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 字节

1.5 KiB Raw Blame History Unescape Escape

IAllocator::Reallocate

相关文档

1.5 KiB

Raw Blame History