WCPNCPY(3) NEWLIB WCPNCPY(3)NAME
7.20 `wcpncpy'--copy part of a wide-character string returning a
pointer to its end
SYNOPSIS
#include <wchar.h>
wchar_t *wcpncpy(wchar_t *S1, const wchar_t *S2, size_t N);
DESCRIPTION
The `wcpncpy' function copies not more than n wide-character codes
(wide-character codes that follow a null wide-character code are not
copied) from the array pointed to by S2 to the array pointed to by S1.
If copying takes place between objects that overlap, the behaviour is
undefined.
If the array pointed to by S2 is a wide-character string that is
shorter than N wide-character codes, null wide-character codes are
appended to the copy in the array pointed to by S1, until N wide-char‐
acter codes in all are written.
RETURNS
The `wcpncpy' function returns S1; no return value is reserved to indi‐
cate an error.
PORTABILITY
`wcpncpy' is ISO/IEC 9899/AMD1:1995 (ISO C).
No supporting OS subroutines are required.
SEE ALSOwcpncpy is part of the library. The full documentation for is main‐
tained as a Texinfo manual. If info and are properly installed at your
site, the command
info
will give you access to the complete manual.
NEWLIB April 2010 WCPNCPY(3)
