free

 

C

编译器支持

语言

头文件

类型支持

程序工具

可变参数函数支持

错误处理

动态内存管理

字符串库

算法

数值

日期和时间工具

输入/输出支持

本地化支持

并发支持 (C11)

技术规范

符号索引

 

动态内存管理

malloc

calloc

realloc

free

free_sized (C23)

free_aligned_sized (C23)

aligned_alloc (C11)

 

定义于头文件 <stdlib.h>
void free( void *ptr );

释放先前由 malloc(), calloc(), aligned_alloc(),(自 C11 起) 或 realloc() 分配的空间。

如果 ptr 是空指针，则该函数不执行任何操作。

如果 ptr 的值不等于先前由 malloc(), calloc(), realloc(), 或 aligned_alloc()(自 C11 起) 返回的值，则行为是未定义的。

如果 ptr 引用的内存区域已被释放，即已使用 ptr 作为参数调用了 free(), free_sized(), free_aligned_sized()(自 C23 起) 或 realloc()，并且之后没有调用 malloc(), calloc(), realloc(), 或 aligned_alloc()(自 C11 起) 导致指针等于 ptr，则行为是未定义的。

如果在 free() 返回后，通过指针 ptr 进行访问（除非另一个分配函数恰好导致指针值等于 ptr），则行为是未定义的。

free 是线程安全的：它的行为就像仅访问通过其参数可见的内存位置，而不访问任何静态存储。 调用 free 以释放内存区域同步于调用任何后续分配函数，该函数分配相同或部分相同的内存区域。此同步发生在释放函数访问内存之后，以及分配函数访问内存之前。在每个特定内存区域上操作的所有分配和释放函数都存在单一的总顺序。

(自 C11 起)

参数

ptr

-

要释放的内存的指针

返回值

（无）

注解

该函数接受（并且对空指针不执行任何操作）以减少特殊情况的数量。无论分配是否成功，分配函数返回的指针都可以传递给 free()。

示例

运行此代码

#include <stdlib.h>
 
int main(void)
{
    int *p1 = malloc(10*sizeof *p1);
    free(p1); // every allocated pointer must be freed
 
    int *p2 = calloc(10, sizeof *p2);
    int *p3 = realloc(p2, 1000*sizeof *p3);
    if(p3) // p3 not null means p2 was freed by realloc
       free(p3);
    else // p3 null means p2 was not freed
       free(p2);
}

参考文献

• C23 标准 (ISO/IEC 9899:2024)

• 7.24.3.3 free 函数 (p: 365)

• C17 标准 (ISO/IEC 9899:2018)

• 7.22.3.3 free 函数 (p: 254)

• C11 标准 (ISO/IEC 9899:2011)

• 7.22.3.3 free 函数 (p: 348)

• C99 标准 (ISO/IEC 9899:1999)

• 7.20.3.2 free 函数 (p: 313)

• C89/C90 标准 (ISO/IEC 9899:1990)

• 4.10.3.2 free 函数

参见

malloc	分配内存 (函数)
free_sized (C23)	释放先前分配的带大小内存 (函数)
free_aligned_sized (C23)	释放先前分配的带大小且对齐的内存 (函数)
C++ 文档，关于 free