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
的指针值),则行为未定义。
要求下列函数是线程安全的:
对这些分配或解分配特定存储单元的函数调用以单独全序出现,并且在此顺序中,每个解分配调用先发生于下个分配(若存在)。 |
(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); }