free
Synopsis
#include <stdlib.h>
void free(void *ptr);
Status
Implemented
Conformance
IEEE Std 1003.1-2017
Description
The free()
function shall cause the space pointed to by ptr to be deallocated; that is, made available for further
allocation.
If ptr is a null pointer, no action shall occur. Otherwise, if the argument does not match a pointer earlier returned
by a function in POSIX.1-2017
that allocates memory as if by malloc()
, or if the space has been deallocated by a
call to free()
or realloc()
, the behavior is undefined.
Any use of a pointer that refers to freed space results in undefined behavior.
Return value
The free()
function shall not return a value.
Errors
No errors are defined.
Tests
Tested
Known bugs
None