Deallocates or frees a memory block.
void free( void *memblock );
Previously allocated memory block to be freed.
free function deallocates a memory block (
memblock) that was previously allocated by a call to
realloc. The number of freed bytes is equivalent to the number of bytes requested when the block was allocated (or reallocated, in the case of
NULL, the pointer is ignored and
free immediately returns. Attempting to free an invalid pointer (a pointer to a memory block that wasn't allocated by
realloc) may affect subsequent allocation requests and cause errors.
If an error occurs in freeing the memory,
errno is set with information from the operating system on the nature of the failure. For more information, see
After a memory block has been freed,
_heapmin minimizes the amount of free memory on the heap by coalescing the unused regions and releasing them back to the operating system. Freed memory that isn't released to the operating system is restored to the free pool and is available for allocation again.
When the application is linked with a debug version of the C run-time libraries,
free resolves to
_free_dbg. For more information about how the heap is managed during the debugging process, see The CRT Debug Heap.
free is marked
__declspec(noalias), meaning that the function is guaranteed not to modify global variables. For more information, see
By default, this function's global state is scoped to the application. To change this, see Global state in the CRT.
For additional compatibility information, see Compatibility.
See the example for
Submit and view feedback for