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 2013-12-16 "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)):
37 _XOPEN_SOURCE\ >=\ 700 || _POSIX_C_SOURCE\ >=\ 200809L
47 function is the wide-character equivalent
53 wide characters from the wide-character
56 including the terminating null wide (L\(aq\\0\(aq),
57 to the array pointed to by
68 the remaining wide characters in the array pointed to
71 are filled with L\(aq\\0\(aq characters.
74 is greater than or equal
77 the string pointed to by
80 not be L\(aq\\0\(aq terminated.
82 The strings may not overlap.
84 The programmer must ensure that there is room for at least
91 returns a pointer to the last wide character written, that is,
94 .SS Multithreading (see pthreads(7))
97 function is thread-safe.