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 2019-03-06 "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 *" dest ", const wchar_t *" src ", size_t " n );
27 Feature Test Macro Requirements for glibc (see
28 .BR feature_test_macros (7)):
34 _POSIX_C_SOURCE >= 200809L
41 function is the wide-character equivalent
47 wide characters from the wide-character
50 including the terminating null wide (L\(aq\e0\(aq),
51 to the array pointed to by
62 the remaining wide characters in the array pointed to
65 are filled with L\(aq\e0\(aq characters.
68 is greater than or equal
71 the string pointed to by
74 not be L\(aq\e0\(aq terminated.
76 The strings may not overlap.
78 The programmer must ensure that there is room for at least
85 returns a pointer to the last wide character written, that is,
88 For an explanation of the terms used in this section, see
96 Interface Attribute Value
99 T} Thread safety MT-Safe