str_alloc_copy

	copied_string.i1p.v = str_alloc_copy(string.i1a.r)

	This routine allocates memory for and copies a string.

	string		string to copy

	This function returns status values as follows:

	pointer to the copied string

	This function requires the following include files:

	cbslib_h

	Related functions:

	str_realloc_copy, strcpy, strncpx, str_copy_array_of_strings_c

	C/C++ usage:

	static const char	string[] = "String";
	char	*copied_string;

	copied_string = str_alloc_copy(string);