©
本文档使用
php中文网手册 发布
在头文件<stdlib.h>中定义 | ||
|---|---|---|
void free(void * ptr); |
将释放的空间以前分配的malloc(),calloc(),aligned_alloc,(因为C11)或realloc()。
如果ptr是空指针,则该函数不执行任何操作。
如果值的行为是不确定ptr不等于一个返回值早些时候malloc(),calloc(),realloc(),或者aligned_alloc()(因为C11)。
如果内存区提到了行为未定义ptr已释放,也就是说,free()或者realloc()已经被调用ptr的参数并没有来电malloc(),calloc()或realloc()导致指针等于ptr算账。
如果在free()返回之后,行为是未定义的,则通过指针进行访问ptr(除非另一个分配函数发生导致指针值等于ptr)。
free是线程安全的:它的行为就像访问通过其参数可见的内存位置,而不是任何静态存储。释放一个内存区域的释放调用将同步 - 调用任何后续分配函数,该函数将分配相同或部分相同区域的内存。在通过释放函数访问内存之后以及在通过分配函数访问内存之前,会发生此同步。所有分配和解除分配功能在内存的每个特定区域都有一个总的顺序。 | (自C11以来) |
|---|
PTR | - | 指向要释放的内存的指针 |
|---|
(none).
注释
该函数接受(并且不执行任何操作)空指针以减少特殊框架的数量。无论分配是否成功,分配函数返回的指针都可以传递给它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);}C11标准(ISO / IEC 9899:2011):
7.22.3.3自由功能(p:348)
C99标准(ISO / IEC 9899:1999):
7.20.3.2自由功能(p:313)
C89 / C90标准(ISO / IEC 9899:1990):
4.10.3.2自由功能