Name
wcpncpy - copy a fixed-size string of wide characters, returning a pointer to its endLibrary
Standard C library ( libc ", " -lc )Synopsis
#include <wchar.h> wchar_t *wcpncpy(wchar_t " dest "[restrict . n ],
const wchar_t " src "[restrict . n ],
size_t n );
Feature Test Macro Requirements for glibc (see feature_test_macros(7)):
wcpncpy()
Since glibc 2.10: _POSIX_C_SOURCE >= 200809L Before glibc 2.10: _GNU_SOURCE
Description
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 bysrc
, including the terminating null wide (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 L'\e0' characters. If the length wcslen(src) is greater than or equal to n
, the string pointed to by dest will not be L'\e0' 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.
Attributes
For an explanation of the terms used in this section, see attributes(7).Interface | Attribute | Value |
T} | Thread safety | MT-Safe |