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

FreeBSD Manual Pages

  
 
  

home | help
xt_malloc(3)		   Library Functions Manual		  xt_malloc(3)

LIBRARY
       #include	<xtend/mem.h>
       -lxtend

SYNOPSIS
       void    *xt_malloc(size_t nelem,	size_t size)

ARGUMENTS
       nelem:  Number of objects to allocate
       size:   Size of a single	object

DESCRIPTION
       xt_malloc()  is a simple	wrapper	around malloc(3) that requires two ar-
       guments representing the	number of objects to allocate and the size  of
       an  element.   This  prevents the very common mistake with malloc(3) of
       forgetting to multiply by the size of an	element.

       Specifying the size using sizeof(*variable) has the advantage of	 being
       type-independent.   I.e.	 if  you change	the type of the	variable, this
       code need not be	updated.  Simply add one  *  to	 whatever  the	return
       value is	assigned to.

RETURN VALUES
       Address of the newly allocated array, or	NULL if	allocation failed

EXAMPLES
       size_t	   widget_list_size = 1024;
       widget_t	   *widgets;

       widgets = xt_malloc(widget_list_size, sizeof(*widgets));

SEE ALSO
       malloc(3)

								  xt_malloc(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=xt_malloc&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>

home | help