NAME
reallocf —
memory reallocation function
LIBRARY
Standard C Library (libc, -lc)
SYNOPSIS
#include
<stdlib.h>
void *
reallocf(void
*ptr, size_t
size);
DESCRIPTION
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.
RETURN VALUES
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.
SEE ALSO
HISTORY
The reallocf() function first appeared in
FreeBSD 3.0.