NAME

wcscat, wcsncat — concatenate wide strings

SYNOPSIS

#include <wchar.h>

wchar_t *
wcscat(wchar_t * restrict s, const wchar_t * restrict append);

wchar_t *
wcsncat(wchar_t * restrict s, const wchar_t * restrict append, size_t count);

DESCRIPTION

The wcscat() and wcsncat() functions append a copy of the wide string append to the end of the wide string s, then add a terminating null wide character (L'\0'). The wide string s must have sufficient space to hold the result.

The wcsncat() function appends not more than count wide characters where space for the terminating null wide character should not be included in count.

RETURN VALUES

The wcscat() and wcsncat() functions return the pointer s.

SEE ALSO

strcat(3), strlcpy(3), wcscpy(3), wcslcpy(3), wmemcpy(3), wmemmove(3)

STANDARDS

The wcscat() and wcsncat() functions conform to ISO/IEC 9899:1999 (“ISO C99”) and were first introduced in ISO/IEC 9899/AMD1:1995 (“ISO C90, Amendment 1”).

HISTORY

The wcscat() and wcsncat() functions were ported from NetBSD and first appeared in OpenBSD 3.8.

CAVEATS

Using the functions wcscat() and wcsncat() is very error-prone with respect to buffer overflows; see the EXAMPLES section in strcat(3) for correct usage. Using wcslcat(3) is a better choice in most cases.