VistaIONew

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.