1 .\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
3 .\" %%%LICENSE_START(GPLv2+_DOC_ONEPARA)
4 .\" This is free documentation; you can redistribute it and/or
5 .\" modify it under the terms of the GNU General Public License as
6 .\" published by the Free Software Foundation; either version 2 of
7 .\" the License, or (at your option) any later version.
10 .\" References consulted:
11 .\" GNU glibc-2 source code and manual
12 .\" Dinkumware C library reference http://www.dinkumware.com/
13 .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html
15 .TH WCPNCPY 3 2021-03-22 "GNU" "Linux Programmer's Manual"
17 wcpncpy \- copy a fixed-size string of wide characters,
18 returning a pointer to its end
23 .BI "wchar_t *wcpncpy(wchar_t *restrict " dest \
24 ", const wchar_t *restrict " src ,
29 Feature Test Macro Requirements for glibc (see
30 .BR feature_test_macros (7)):
36 _POSIX_C_SOURCE >= 200809L
43 function is the wide-character equivalent
49 wide characters from the wide-character
52 including the terminating null wide (L\(aq\e0\(aq),
53 to the array pointed to by
64 the remaining wide characters in the array pointed to
67 are filled with L\(aq\e0\(aq characters.
70 is greater than or equal
73 the string pointed to by
76 not be L\(aq\e0\(aq terminated.
78 The strings may not overlap.
80 The programmer must ensure that there is room for at least
87 returns a pointer to the last wide character written, that is,
90 For an explanation of the terms used in this section, see
98 Interface Attribute Value
101 T} Thread safety MT-Safe