free

释放先前由 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() 。

示例

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

参考文献

参见