wcsncat()

Updated: April 19, 2023

Concatenate two wide-character strings, up to a maximum length

Synopsis:

#include <wchar.h>

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

Arguments:

ws1, ws2
The wide-character strings that you want to concatenate.
n
The maximum number of wide characters that you want to add from the ws2 string.

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

Description:

The wcsncat() function appends a copy of the string pointed to by ws2, including the terminating NUL wide character, to the end of the string pointed to by ws1. The first character of ws2 overwrites the NUL wide character at the end of ws1. The function writes no more than n wide characters from ws2 and appends a NUL wide character to the result.

Returns:

The same pointer as ws1.

Classification:

ANSI, POSIX 1003.1

Safety:  
Cancellation point No
Interrupt handler Yes
Signal handler Yes
Thread Yes