copy a wide character string with bound
wchar_t *wcsncpy(wchar_t *ws1,const wchar_t *ws2, size_t n);
wcsncpy copies exactly n wide characters, truncating
the wide string ws2 or adding null wide characters to
ws1, if necessary. Wide characters that follow a null
wide character are not copied.
The result will not be null-terminated if the length of
ws2 is n or more.
If the array ws2 points to is a wide character string that is shorter
than n wide characters, the copy in the array pointed to by
ws1 is padded with null wide characters until a total of n wide
characters is written.
This function does not check for an overflow condition of the array pointed
to by ws1.
wcsncpy returns ws1.
Overlapping moves may cause unexpected results because
the movement of wide characters is implementation-dependent.
If there is no null wide character in the first n wide characters
of the array pointed to
by ws2, the result will not be null-terminated.
© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004