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.