NAME

       VistaIONewString - allocate a copy of a string

SYNOPSIS

       #include <vistaio.h>

       VistaIOString VistaIONewString (string)
              VistaIOString string;

ARGUMENTS

       string    Specifies a null-terminated string.

DESCRIPTION

       VistaIONewString  copies a string into a newly-allocated block of memory, which it obtains
       using VistaIOMalloc(3). It is a convenience macro that  calls  VistaIOMalloc(3)  with  the
       following arguments specified:

              (strcpy (VistaIOMalloc (strlen (string) + 1), string))

RETURN VALUES

       VistaIONewString returns a pointer to the new copy of the string.

SEE ALSO

       VistaIOMalloc(3), VistaIONew(3), VistaIOError(3),

DIAGNOSTICS

       If  there is insufficient memory to allocate the new block, VistaIONewString 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.