NAME

       reallocf — general purpose memory allocation functions

LIBRARY

       Utility functions from BSD systems (libbsd, -lbsd)

SYNOPSIS

       #include <stdlib.h>
       (See libbsd(7) for include usage.)

       void *
       reallocf(void *ptr, size_t size);

DESCRIPTION

       The  reallocf()  function  changes  the size of the previously allocated memory referenced by ptr to size
       bytes.  The contents of the memory are unchanged up to the lesser of the new and old sizes.  If  the  new
       size  is  larger, the contents of the newly allocated portion of the memory are undefined.  Upon success,
       the memory referenced by ptr is freed and a pointer to the newly allocated memory is returned.  Note that
       reallocf() may move the memory allocation, resulting in a different return value than  ptr.   If  ptr  is
       NULL, the reallocf() function behaves identically to malloc() for the specified size.  Upon failure, when
       the  requested  memory  cannot  be  allocated,  the  passed  pointer  is  freed to ease the problems with
       traditional coding styles for reallocf() 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 buffer is deallocated in this case.

SEE ALSO

       brk(2), mmap(2), alloca(3), calloc(3), free(3), malloc(3), posix_memalign(3), realloc(3),

HISTORY

       The reallocf() function first appeared in FreeBSD 3.0.

Debian                                         September 26, 2009                                 reallocf(3bsd)