Manual Pages  — MALLOC

reallocf – memory reallocation function

LIBRARY SYNOPSIS DESCRIPTION RETURN VALUES SEE ALSO HISTORY

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 .