free

释放或释放内存块。

void free( 
   void *memblock 
);

参数

  • memblock
    此前分配的内存块已释放。

备注

free 函数释放由 calloc、 malloc或 realloc的调用此前分配的内存块 (memblock)。已释放的字节数。与请求的字节数等效,当某个块 (或重新分配,在 realloc)。如果 memblock 是 NULL,指针会被忽略,并且 free 立即返回。尝试释放了无效的指针 (可 calloc、 malloc或 realloc未分配的指针内存块可能会影响后续分配请求并导致错误。

如果错误发生在释放内存, errno 设置与操作系统的信息在失败的性质。有关更多信息,请参见 errno、_doserrno、_sys_errlist和_sys_nerr

在内存块已释放后, _heapmin 通过联合未使用的区域和释放它们从而最大限度地减少了堆中的可用内存回操作系统。未释放给操作系统中释放的内存量还原为可用池并为分配再次可用。

当应用程序使用 C 运行库时的调试版本链接, free 解析为 _free_dbg。有关堆方式的更多信息管理在调试过程中,请参见 CRT 调试堆

free 标记为 __declspec(noalias),这意味着函数保证不修改全局变量。有关更多信息,请参见 noalias

若要释放内存分配与 _malloca,请使用 _freea

要求

功能

必需的头

free

stdlib.h 和 malloc.h

有关其他的兼容性信息,请参见中介绍的 兼容性

示例

malloc参见示例。

.NET Framework 等效项

不适用。若要调用标准 C 函数,请使用 PInvoke。有关更多信息,请参见 平台调用示例

请参见

参考

内存分配

_alloca

calloc

malloc

realloc

_free_dbg

_heapmin

_freea