reallocf
—
memory reallocation function
Standard C Library (libc, -lc)
#include <stdlib.h>
void *
reallocf
(void
*ptr, size_t
size);
The reallocf
() function is identical to the
realloc
() function, except that it will free the
passed pointer when the requested memory cannot be allocated. This is a
FreeBSD specific API designed to ease the problems
with traditional coding styles for realloc
() causing
memory leaks in libraries.
The reallocf
() function returns a pointer, possibly
identical to ptr, to the allocated memory if successful;
otherwise a NULL
pointer is returned, and
errno is set to ENOMEM
if the
error was the result of an allocation failure. The
reallocf
() function deletes the original buffer when
an error occurs.
The reallocf
() function first appeared in
FreeBSD 3.0.