< cpp‎ | memory‎ | c
Defined in header <cstdlib>
void free( void* ptr );

Deallocates the space previously allocated by std::malloc(), std::calloc() or std::realloc(). If ptr is null-pointer, the function does nothing.

The behavior is undefined if ptr does not match a pointer returned earlier by std::malloc(), std::calloc() or std::realloc(). Also, the behavior is undefined if the memory area referred to by ptr has already been deallocated, that is, free() or std::realloc() has already been called with ptr as the argument and no calls to std::malloc(), std::calloc() or std::realloc() resulted in a pointer equal to ptr afterwards.


[edit] Parameters

ptr - pointer to the memory to deallocate

[edit] Return value


[edit] Example

[edit] See also

C documentation for free