std::free

在标头 `<cstdlib>` 定义
void free( void* ptr );

解分配先前由 std::malloc() 、 std::calloc() 、 std::aligned_alloc (C++17 起) 或 std::realloc() 分配的内存空间。

若 ptr 是空指针，则函数不做任何事。

若 ptr 的值不等于先前 std::malloc() 、 std::calloc() 、 std::aligned_alloc (C++17 起) 或 std::realloc() 返回的值，则行为未定义。

若 ptr 所指代的内存区域已被解分配，即已以 ptr 为参数掉调用 std::free() 或 std::realloc() ，且无对 std::malloc() 、 std::calloc() 、 std::aligned_alloc (C++17 起) 或 std::realloc() 产生等于之前 ptr 的指针，则行为未定义。

若在 std::free() 返回后，通过指针 ptr 访问（除非另一分配函数恰好产生等于 ptr 的指针值），则行为未定义。

要求下列函数是线程安全的：

new 运算符和 delete 运算符的库版本
全局 new 运算符和 delete 运算符的用户替换版本
std::calloc、std::malloc、std::realloc、std::aligned_alloc (C++17 起)、std::free

对这些分配或解分配特定存储单元的函数调用以单独全序出现，而并且在此顺序中，每个解分配调用先发生于下个分配（如果存在）。

(C++11 起)

参数

ptr

-

指向要解分配的内存的指针

返回值

（无）

注意

此函数接受空指针（不做任何事）以减少特殊情况的总数。无论分配是否成功，分配函数返回的指针都能传递给 free() 。

示例

运行此代码

#include <cstdlib>
 
int main()
{
    int* p1 = (int*)std::malloc(10*sizeof *p1);
    std::free(p1); // 每个分配的指针都必须释放
 
    int* p2 = (int*)std::calloc(10, sizeof *p2);
    int* p3 = (int*)std::realloc(p2, 1000*sizeof *p3);
    if(p3) // p3 非空表示 p2 为 std::realloc 所释放
       std::free(p3);
    else // p3 空表示 p2 未被释放
       std::free(p2);
}

编译器支持
自立实现与有宿主实现
语言
标准库
标准库标头
具名要求
功能特性测试宏 (C++20)
语言支持库
概念库 (C++20)
元编程库 (C++11)
诊断库
通用工具库
字符串库
容器库
迭代器库
范围库 (C++20)
算法库
数值库
本地化库
输入/输出库
文件系统库 (C++17)
正则表达式库 (C++11)
并发支持库 (C++11)
技术规范
符号索引
外部库

std::free

参数

返回值

注意

示例

参阅

导航