wcsncpy()

Copy a wide-character string, to a maximum length

Synopsis:

#include <wchar.h>

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

Arguments:

ws1: A pointer to where you want to copy the wide-character string.
ws2: The wide-character string that you want to copy.
n: The maximum number of wide characters that you want to copy.

Library:

libc

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

Description:

The wcsncpy() function copies the string pointed to by ws2, including the terminating NUL wide character, into the array pointed to by ws1, to a maximum of n wide characters. It adds NUL characters if ws2 has fewer than n characters but doesn't add a NUL if ws2 has more.

Note: This function isn't guaranteed to work properly for copying overlapping strings; use wmemmove() instead.

Returns:

The same pointer as ws1.

Classification:

ANSI, POSIX 1003.1

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