Guardian Native C Library Calls Reference Manual (G06.29+, H06.08+, J06.03+)

Guardian Native C Library Calls (t - z) wcscat(3)
NAME
wcscat - Appends one wide-character string to 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 *wcscat(
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 wcscat() function appends a copy of the wide-character string pointed to by the wcstring2
parameter (including the terminating null wide-character code) to the end of the wide-character
string pointed to by the wcstring1 parameter. The initial wide-character code of wcstring2
overwrites the null wide-character code at the end of wcstring1.
RETURN VALUES
Upon successful completion, the wcscat( ) 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), wcschr(3), wcscmp(3), wcscoll(3), wcscpy(3),
wcsncat(3), wcscspn(3).
527192-018 Hewlett-Packard Company 7−133