The
wcpncpy()
function is the wide-character equivalent
of the
stpncpy(3)
function.
It copies at most n wide characters from the wide-character
string pointed to by src,
including the terminating Laq\0aq character,
to the array pointed to by dest.
Exactly n wide characters are
written at dest.
If the length wcslen(src) is smaller than n,
the remaining wide characters in the array pointed to
by dest are filled with Laq\0aq characters.
If the length wcslen(src) is greater or equal
to n, the string pointed to by dest will
not be Laq\0aq terminated.
The strings may not overlap.
The programmer must ensure that there is room for at least n wide
characters at dest.
RETURN VALUE
wcpncpy()
returns a pointer to the last wide character written, that is,
dest + n - 1.
This page is part of release 3.14 of the Linux
man-pages
project.
A description of the project,
and information about reporting bugs,
can be found at
http://www.kernel.org/doc/man-pages/.
