REALLOCF(3) - man page online | library functions
General purpose memory allocation functions.
September 26, 2009
MALLOC(3) BSD Library Functions Manual MALLOC(3)
NAMEreallocf — general purpose memory allocation functions
LIBRARYUtility functions from BSD systems (libbsd, -lbsd)
SYNOPSIS#include <bsd/stdlib.h> void * reallocf(void *ptr, size_t size);
DESCRIPTIONThe 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 alloca‐ tion, resulting in a different return value than ptr. If ptr is NULL, the reallocf() func‐ tion 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 VALUESThe reallocf() function returns a pointer, possibly identical to ptr, to the allocated mem‐ ory 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 ALSObrk(2), mmap(2), alloca(3), calloc(3), free(3), malloc(3), posix_memalign(3), realloc(3),
BSD September 26, 2009 BSD
HISTORYThe reallocf() function first appeared in FreeBSD 3.0.
|This manual||Reference||Other manuals|
|refer to||alloca(3) | brk(2) | malloc(3) | mmap(2) | posix_memalign(3)|