NAME¶
VistaIONewString - allocate a copy of a string
SYNOPSIS¶
#include <vistaio.h>
VistaIOString VistaIONewString (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.
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.