Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
xalloc(l)			BEGEMOT	Library			     xalloc(l)

NAME
       xalloc, xrealloc	- memory allocation with simple	error check

SYNOPSIS
       # 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) func-
       tions.  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)

BEGEMOT				  31 May 1996			     xalloc(l)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=xalloc&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help