wcsncpy()

Copy a wide-character string, to a maximum length

Synopsis:

#include <wchar.h>

wchar_t * wcsncpy( wchar_t * ws1,
                   const char * 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.

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.

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