std::realloc

重分配给定的内存区域。它必须是 std::malloc() 、 std::calloc() 或 std::realloc() 先前分配的，且仍未被 std::free() 释放，否则行为未定义。

重分配按以下之一进行：

若无足够内存，则不释放旧块并返回空指针。

è‹¥ ptr 是空指针，则行为同调用 std::malloc(new_size) 。

è‹¥ new_size 为零，则行为是实现定义的：可以返回空指针（该情况下可能或可能不释放旧内存块），或可能返回某个不可用于访问存储的非空指针。

参数

返回值

成功时，返回指向新分配内存起始的指针。为避免内存泄漏，返回的必须以 std::free() 解分配指针。原指针 ptr 被非法化，且任何对它的访问是未定义行为（即使重分配是原位的）。

失败时，返回空指针。原指针 ptr 保持合法且可能需要以 std::free() 解分配。

注意

因为重分配可能涉及逐位复制（无论是扩展还是压缩），调用 realloc 后，只有可平凡复制 (TriviallyCopyable) 类型才能安全地于内存块的保留位置访问。

一些非标准库定义类型特性“可逐位移动 (BitwiseMovable) ”或“可重定位 (Relocatable) ”，这描述不拥有下列内容的类型：

• 外部引用（例如链表或树的保有另一元素引用的结点），和
• 内部引用（例如，可能保有另一成员地址的成员指针）。

重分配其存储后，能访问这种类型的对象，即使其复制构造函数非平凡。

示例

#include <cstdlib>
#include <new>
#include <cassert>
 
class MallocDynamicBuffer
{
    char* p;
public:
    explicit MallocDynamicBuffer(std::size_t initial = 0) : p(nullptr) {
       resize(initial);
    }
    ~MallocDynamicBuffer() { std::free(p); }
    void resize(std::size_t newSize) {
        if(newSize == 0) { // 此检查并非严格需要，但零大小 realloc 于 C 中弃用 
            std::free(p);
            p = nullptr;
        } else {
            if(void* mem = std::realloc(p, newSize))
                p = static_cast<char*>(mem);
            else
                throw std::bad_alloc();
        }
    }
    char& operator[](size_t n) { return p[n]; }
    char operator[](size_t n) const { return p[n]; }
};
 
int main()
{
    MallocDynamicBuffer buf1(1024);
    buf1[5] = 'f';
    buf1.resize(10); // 收缩
    assert(buf1[5] == 'f');
    buf1.resize(1024); // 增长
    assert(buf1[5] == 'f');
}

参阅