NAME

       VistaIOMalloc, VistaIOCalloc, VistaIORealloc, VistaIOFree - memory allocation functions

SYNOPSIS

       VistaIOPointer VistaIOMalloc (size_t size);

       VistaIOPointer VistaIOCalloc (size_t num, size_t elsize);

       VistaIOPointer VistaIORealloc (VistaIOPointer ptr, size_t size);

       void VistaIOFree (VistaIOPointer ptr);

ARGUMENTS

       size      Specifies the number of bytes desired.

       num       Specifies the number of array elements desired.

       elsize    Specifies the size of an array element, in bytes.

       ptr       Specifies a pointer to the old storage or to the block of storage that is to be freed.

DESCRIPTION

       The  VistaIOMalloc  function  returns  a pointer to a block of storage of at least size bytes. It returns
       NULL, however, if size is zero.

       The VistaIOCalloc function allocates space for num array elements of the size  elsize,  initializing  the
       space to zero bits. Like VistaIOMalloc, it returns NULL if asked to allocate zero space.

       The  VistaIORealloc  function changes a block of storage, pointed to by ptr, to be of size size (possibly
       moving it). If necessary, it allocates a new block at a different location, copies the old  contents  (or
       as  much  as  will  fit) into the new block, and then frees the old block. If ptr is NULL, VistaIORealloc
       allocates the new storage without copying the old contents; that is, it simply  calls  VistaIOMalloc.  If
       size is zero, it frees storage pointed to by ptr and returns NULL.

       The  VistaIOFree  function  frees  storage,  allowing it to be reused. If ptr is NULL, VistaIOFree has no
       effect.

RETURN VALUES

       VistaIOMalloc, VistaIOCalloc, and VistaIORealloc each return a pointer to the allocated storage.

       VistaIOFree does not return a value.

SEE ALSO

       malloc(3), VistaIONew(3), VistaIONewString(3), VistaIOError(3),

DIAGNOSTICS

       If there is  insufficient  memory  to  allocate  a  requested  block,  VistaIOMalloc,  VistaIOCalloc,  or
       VistaIORealloc will terminate by calling VistaIOError(3) with the message ``Memory allocation failure''.

AUTHOR

       Art Pope <pope@cs.ubc.ca>

       Adaption to vistaio: Gert Wollny <gw.fossdev@gmail.com>

ACKNOWLEDGMENT

       These  functions  and  this  manual  page are based on similar ones included in the X Toolkit Intrinsics,
       which  is  Copyright  1985,  1986,  1987,  1988  Massachusetts  Institute   of   Technology,   Cambridge,
       Massachusetts, and Digital Equipment Corporation, Maynard, Massachusetts.