wcsncpy()

Copy a string, to a maximum length

Synopsis:

#include <wchar.h>

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

Library:

libc

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.

Because these functions aren't guaranteed to work properly for copying overlapping strings, use the wmemmove() functions instead.

Returns:

A pointer to ws1.

Classification:

ANSI

See also:

"String manipulation functions" and "Wide-character functions" in the summary of functions chapter.