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.