|
Unix VPS
Support
FAQ
Network
Miscellaneous
|
| xalloc(l) | BEGEMOT Library | xalloc(l) |
NAME
xalloc, xrealloc - memory allocation with simple error checkSYNOPSIS
# include <begemot.h>
void * xalloc(size_t size);
void * xrealloc(void *ptr, size_t size);
void xfree(void *ptr);
DESCRIPTION
These functions are a layer above the malloc(3C) and realloc(3C) functions. They call these basic functions and check whether the returned pointer is NULL. In this case panic(l) is called with the message 'Out of memory: param' , where param are the parameters to the allocation function.See malloc(3C) and realloc(3C) for a description of the arguments.
These functions have the following additional features:
- -
- xalloc(0) returns a unique pointer for each call.
- -
- xfree(NULL) is legal.
- -
- xrealloc(NULL, 0) behaves like xalloc(0).
- -
- xrealloc(NULL, s) will behave like xalloc(s).
- -
- xrealloc(p, 0) behaves like a sequence of free(p) and xalloc(0).
RETURN VALUE
See malloc(3C) and realloc(3C) for a description of the return values. Note that these functions never return NULL.SEE ALSO
malloc(3C), realloc(3C), panic(l)| 31 May 1996 | BEGEMOT |
Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.