logo
Free, unlimited AI code reviews that run on commit
git-lrc git-lrc GitHub Install Now We'd appreciate a star git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt

VistaIOMalloc, VistaIOCalloc, VistaIORealloc, VistaIOFree - memory allocation functions

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,  Massachu‐
       setts, and Digital Equipment Corporation, Maynard, Massachusetts.

VistaIO Version 1.2.14                             3 June 1994                                  VistaIOMalloc(3)

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.

Author

       Art Pope <pope@cs.ubc.ca>

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

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.

Diagnostics

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

Name

       VistaIOMalloc, VistaIOCalloc, VistaIORealloc, VistaIOFree - memory allocation functions

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),

Synopsis

VistaIOPointerVistaIOMalloc(size_tsize);VistaIOPointerVistaIOCalloc(size_tnum,size_telsize);VistaIOPointerVistaIORealloc(VistaIOPointerptr,size_tsize);voidVistaIOFree(VistaIOPointerptr);

See Also