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