Open System Services Library Calls Reference Manual (G06.29+, H06.08+, J06.03+)

OSS Library Calls (w - 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL
32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll
64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll
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).
527187-017 Hewlett-Packard Company 8−9