Name
wcsncpy - copy a fixed-size string of wide charactersLibrary
Standard C library ( libc ", " -lc )Synopsis
#include <wchar.h> wchar_t *wcsncpy(wchar_t " dest "[restrict . n ],
const wchar_t " src "[restrict . n ],
size_t n );
Description
The wcsncpy() function is the wide-character equivalent of the strncpy(3) function. It copies at most n wide characters from the wide-character string pointed to bysrc
, including the terminating null wide character (L'\e0'), 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 null wide characters. If the length wcslen(src) is greater than or equal to n
, the string pointed to by dest will not be terminated by a null wide character. The strings may not overlap.
The programmer must ensure that there is room for at least n wide characters at dest
.
Return Value
wcsncpy() returnsdest
. Attributes
For an explanation of the terms used in this section, see attributes(7).Interface | Attribute | Value |
T} | Thread safety | MT-Safe |
Standards
C11, POSIX.1-2008.History
POSIX.1-2001, C99.See Also
- strncpy(3)