NAME

       VistaIONew - allocate storage for an instance of a data type

SYNOPSIS

       #include <vistaio.h>

       type *VistaIONew (type)
              type;

ARGUMENTS

       type      Specifies a previously declared data type.

DESCRIPTION

       VistaIONew  allocates  storage  for one instance of a data type. It is a convenience macro
       that calls VistaIOMalloc(3) with the following arguments specified:

              ((type *) VistaIOMalloc (sizeof (type))

RETURN VALUES

       VistaIONew returns a pointer to the allocated storage.

SEE ALSO

       VistaIOMalloc(3), VistaIONewString(3), VistaIOError(3),

DIAGNOSTICS

       If there is insufficient memory to  allocate  the  new  block,  VistaIONew  terminates  by
       calling VistaIOError(3) with the message ``Out of memory''.

AUTHOR

       Art Pope <pope@cs.ubc.ca>

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

ACKNOWLEDGMENT

       This  macro  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.