std::free
来自cppreference.com
在标头 <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 | - | 指向要解分配的内存的指针 |
[编辑]返回值
（无）
[编辑]注解
此函数接受空指针（不做任何事）以减少特殊情况的总数。无论分配是否成功，分配函数返回的指针都能传递给 std::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 为空表示 realloc 失败，而必须释放 p2 std::free(p2); std::free(p3);// p3 无论是否为空都可以释放}
[编辑]参阅
free 的 C 文档 |
