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 argu-
     ments representing the number of objects to allocate and the size of an el-
     ement.  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 as-
     signed 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+15.1.quarterly>

home | help