]>
Commit | Line | Data |
---|---|---|
a1eaacb1 | 1 | '\" t |
fea681da MK |
2 | .\" Copyright (c) Bruno Haible <haible@clisp.cons.org> |
3 | .\" | |
e4a74ca8 | 4 | .\" SPDX-License-Identifier: GPL-2.0-or-later |
fea681da MK |
5 | .\" |
6 | .\" References consulted: | |
7 | .\" GNU glibc-2 source code and manual | |
8 | .\" Dinkumware C library reference http://www.dinkumware.com/ | |
008f1ecc | 9 | .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html |
fea681da | 10 | .\" |
4c1c5274 | 11 | .TH wcpcpy 3 (date) "Linux man-pages (unreleased)" |
fea681da | 12 | .SH NAME |
d0f17b57 | 13 | wcpcpy \- copy a wide-character string, returning a pointer to its end |
11f29974 AC |
14 | .SH LIBRARY |
15 | Standard C library | |
8fc3b2cf | 16 | .RI ( libc ", " \-lc ) |
fea681da MK |
17 | .SH SYNOPSIS |
18 | .nf | |
fea681da | 19 | .B #include <wchar.h> |
c6d039a3 | 20 | .P |
12ba9d41 AC |
21 | .BI "wchar_t *wcpcpy(wchar_t *restrict " dest \ |
22 | ", const wchar_t *restrict " src ); | |
fea681da | 23 | .fi |
c6d039a3 | 24 | .P |
d39ad78f | 25 | .RS -4 |
d834047b MK |
26 | Feature Test Macro Requirements for glibc (see |
27 | .BR feature_test_macros (7)): | |
d39ad78f | 28 | .RE |
c6d039a3 | 29 | .P |
d834047b | 30 | .BR wcpcpy (): |
9d2adbae MK |
31 | .nf |
32 | Since glibc 2.10: | |
5c10d2c5 | 33 | _POSIX_C_SOURCE >= 200809L |
9d2adbae MK |
34 | Before glibc 2.10: |
35 | _GNU_SOURCE | |
36 | .fi | |
fea681da | 37 | .SH DESCRIPTION |
60a90ecd MK |
38 | The |
39 | .BR wcpcpy () | |
40 | function is the wide-character equivalent of the | |
3a72373c | 41 | .BR stpcpy (3) |
c13182ef | 42 | function. |
e4a0d6cb MK |
43 | It copies the wide-character string pointed to by |
44 | .IR src , | |
b957f81f | 45 | including the terminating null wide character (L\[aq]\e0\[aq]), |
e9c23bc6 | 46 | to the array pointed to by |
e4a0d6cb | 47 | .IR dest . |
c6d039a3 | 48 | .P |
fea681da | 49 | The strings may not overlap. |
c6d039a3 | 50 | .P |
f81fb444 | 51 | The programmer must ensure that there |
e4a0d6cb | 52 | is room for at least |
1ae6b2c7 | 53 | .I wcslen(src)+1 |
e4a0d6cb MK |
54 | wide characters at |
55 | .IR dest . | |
47297adb | 56 | .SH RETURN VALUE |
60a90ecd MK |
57 | .BR wcpcpy () |
58 | returns a pointer to the end of the wide-character string | |
e4a0d6cb MK |
59 | .IR dest , |
60 | that is, a pointer to the terminating null wide character. | |
9d5acc26 | 61 | .SH ATTRIBUTES |
6f4869ff PH |
62 | For an explanation of the terms used in this section, see |
63 | .BR attributes (7). | |
64 | .TS | |
65 | allbox; | |
c466875e | 66 | lbx lb lb |
6f4869ff PH |
67 | l l l. |
68 | Interface Attribute Value | |
69 | T{ | |
9e54434e BR |
70 | .na |
71 | .nh | |
9d5acc26 | 72 | .BR wcpcpy () |
6f4869ff PH |
73 | T} Thread safety MT-Safe |
74 | .TE | |
3113c7f3 | 75 | .SH STANDARDS |
d9a8bda4 | 76 | POSIX.1-2008. |
47297adb | 77 | .SH SEE ALSO |
fea681da | 78 | .BR strcpy (3), |
0a4f8b7b | 79 | .BR wcscpy (3) |