Guardian Native C Library Calls Reference Manual (G06.28+, H06.04+)

Guardian Native C Library Calls (t - z) wcscpy(3)
NAME
wcscpy - Copies one wide-character string into another
LIBRARY
G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL
G-series native OSS processes: /G/system/sysnn/zcrtlsrl
H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL
H-series OSS processes: /G/system/zdllnnn/zcrtldll
SYNOPSIS
#include <wchar.h>
wchar_t *wcscpy(
wchar_t *wcstring1,
const wchar_t *wcstring2);
PARAMETERS
wcstring1 Points to a location containing the first wide-character string.
wcstring2 Points to a location containing the second wide-character string.
DESCRIPTION
The wcscat( ), wcscmp(), and wcscpy() functions operate on null-terminated, wide-character
strings. The string arguments to these functions are expected to contain a null wide character
marking the end of the string. Boundary checking is not done when a copy or concatenation
operation is performed.
The wcscpy() function copies the contents of the wcstring2 parameter (including the ending
wchar_t null character) into the wcstring1 parameter. If copying occurs between overlapping
objects, the behavior of the wcscpy() function is undefined.
RETURN VALUES
Upon successful completion, the wcscpy() function returns a pointer to the resulting string,
wcstring1. Otherwise, this function returns a null pointer.
RELATED INFORMATION
Functions: strcat(3), strcmp(3), strcpy(3), wcscat(3), wcschr(3), wcscmp(3), wcscoll(3),
wcsncat(3), wcscspn(3).
527192-005 Hewlett-Packard Company 7−55