FreeBSD manual
download PDF document: reallocf.3.pdf
MALLOC(3) FreeBSD Library Functions Manual MALLOC(3)
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
realloc(3)
HISTORY
The reallocf() function first appeared in FreeBSD 3.0.
FreeBSD 14.0-RELEASE-p6 January 31, 2010 FreeBSD 14.0-RELEASE-p6