Next: , Previous: wcsncmp, Up: Wchar strings


6.18 wcsncpy—copy part of a wide-character string

Synopsis

     #include <wchar.h>
     wchar_t *wcsncpy(wchar_t *s1, const wchar_t *s2, size_t n);
     

Description
The wcsncpy 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-character codes in all are written.


Returns
The wcsncpy function returns s1; no return value is reserved to indicate an error.


Portability
wcsncpy is ISO/IEC 9899/AMD1:1995 (ISO C).

No supporting OS subroutines are required.