1WCSNCPY(3)                 Linux Programmer's Manual                WCSNCPY(3)
2
3
4

NAME

6       wcsncpy - copy a fixed-size string of wide characters
7

SYNOPSIS

9       #include <wchar.h>
10
11       wchar_t *wcsncpy(wchar_t *dest, const wchar_t *src, size_t n);
12

DESCRIPTION

14       The   wcsncpy()  function  is  the  wide-character  equivalent  of  the
15       strncpy(3) function.  It copies at most  n  wide  characters  from  the
16       wide-character  string  pointed  to  by  src, including the terminating
17       L'\0' character, to the array pointed to by dest.  Exactly n wide char‐
18       acters  are written at dest.  If the length wcslen(src) is smaller than
19       n, the remaining wide characters in the array pointed to  by  dest  are
20       filled  with L'\0' characters.  If the length wcslen(src) is greater or
21       equal to n, the string pointed to by dest will not be L'\0' terminated.
22
23       The strings may not overlap.
24
25       The programmer must ensure that there is room for at least n wide char‐
26       acters at dest.
27

RETURN VALUE

29       wcsncpy() returns dest.
30

CONFORMING TO

32       C99.
33

SEE ALSO

35       strncpy(3)
36

COLOPHON

38       This  page  is  part of release 3.25 of the Linux man-pages project.  A
39       description of the project, and information about reporting  bugs,  can
40       be found at http://www.kernel.org/doc/man-pages/.
41
42
43
44GNU                               1999-07-25                        WCSNCPY(3)