1 .\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
3 .\" SPDX-License-Identifier: GPL-2.0-or-later
5 .\" References consulted:
6 .\" GNU glibc-2 source code and manual
7 .\" Dinkumware C library reference http://www.dinkumware.com/
8 .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html
10 .TH WCPNCPY 3 2021-03-22 "GNU" "Linux Programmer's Manual"
12 wcpncpy \- copy a fixed-size string of wide characters,
13 returning a pointer to its end
16 .RI ( libc ", " \-lc )
21 .BI "wchar_t *wcpncpy(wchar_t *restrict " dest \
22 ", const wchar_t *restrict " src ,
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