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.