Your Browser is not longer supported

Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly
Loading...

{{viewport.spaceProperty.prod}}

wcsncat - concatenate two wide character strings

&pagelevel(4)&pagelevel

Syntax

#include <wchar.h>

wchar_t *wcsncat(wchar_t *ws1, const wchar_t *ws2, size_t n);

Description

wcsncat() appends a maximum of n characters of the wide character string ws2 to the end
of the wide character string ws1 and returns a pointer to ws1.

The terminating null wide character code (\0) at the end of the wide character string ws1 is
overwritten by the first byte of the wide character string ws2.

If the wide character string ws2 contains less than n characters, only the characters in ws2
will be appended to ws1, and if ws2 contains more than n characters, then only the leading
n characters of ws2 will be appended to ws1.

wcsncat() terminates the wide character string with a null wide character code (\0).

Return val.

Notes

Pointer to the resulting wide character string ws1.

Wide character strings terminated with a null wide character code (\0) are expected as
arguments.

wcsncat() does not verify whether ws1 has enough space to accommodate the result.
The behavior is undefined if memory areas overlap.

Restriction
This version of the C runtime system only supports 1-byte characters as wide character
codes. They are of type wchar_t (see stddef.h). (End)

See also

wcscat(), wchar.h.