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

Guardian Native C Library Calls (t - z) wcsncat(3)
NAME
wcsncat - Appends wide-character strings with a character count
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 *wcsncat(
wchar_t *wcstring1,
const wchar_t *wcstring2,
size_t number);
PARAMETERS
wcstring1 Points to a location that contains the first wide-character string.
wcstring2 Points to a location that contains the second wide-character string.
number Specifies the number of wide characters to append.
DESCRIPTION
The wcsncat( ), wcsncmp(), and wcsncpy() functions operate on null-terminated, wide-
character strings.
The wcsncat( ) function appends characters from the wcstring2 parameter to the end of the
wcstring1 parameter. The initial character of the wcstring2 parameter overwrites the terminating
null wide character of the wcstring1 parameter. The wcsncat() function appends at most the
number of characters specified by the value of the number parameter minus 1. It then appends a
null wide character to the result, and returns wcstring1. When operating on overlapping strings,
the behavior of this function is unreliable.
RETURN VALUES
Upon successful completion, the wcsncat() function returns a pointer to the resulting string.
Otherwise, this function returns a null pointer.
When a successful comparison cannot be made, this function returns a value of 0 (zero).
RELATED INFORMATION
Functions: strncat(3) wcschr(3), wcscmp(3), wcscpy(3), wcscspn(3), wcsncmp(3), wcsncpy(3).
527192-007 Hewlett-Packard Company 7−67