Debian Codegraph @

upstream/debian-unstable/man3/wcscpy.3

raw
1 '\" t
2 .\" Copyright, Bruno Haible <[email protected]>
3 .\" Copyright, the authors of the Linux man-pages project
4 .\"
5 .\" SPDX-License-Identifier: GPL-2.0-or-later
6 .\"
7 .TH wcscpy 3 2026-02-08 "Linux man-pages 6.18"
8 .SH NAME
9 wcscpy \- copy a wide-character string
10 .SH LIBRARY
11 Standard C library
12 .RI ( libc ,\~ \-lc )
13 .SH SYNOPSIS
14 .nf
15 .B #include <wchar.h>
16 .P
17 .BI "wchar_t *wcscpy(wchar_t *restrict " dest \
18 ", const wchar_t *restrict " src );
19 .fi
20 .SH DESCRIPTION
21 The
22 .BR wcscpy ()
23 function is the wide-character equivalent
24 of the
25 .BR strcpy (3)
26 function.
27 It copies the wide-character string pointed to by
28 .IR src ,
29 including the terminating null wide character (L\[aq]\[rs]0\[aq]),
30 to the array pointed to by
31 .IR dest .
32 .P
33 The strings may not overlap.
34 .P
35 The programmer must ensure that there is
36 room for at least
37 .I wcslen(src)+1
38 wide characters at
39 .IR dest .
40 .SH RETURN VALUE
41 .BR wcscpy ()
42 returns
43 .IR dest .
44 .SH ATTRIBUTES
45 For an explanation of the terms used in this section, see
46 .BR attributes (7).
47 .TS
48 allbox;
49 lbx lb lb
50 l l l.
51 Interface Attribute Value
52 T{
53 .na
54 .nh
55 .BR wcscpy ()
56 T} Thread safety MT-Safe
57 .TE
58 .SH STANDARDS
59 C11, POSIX.1-2008.
60 .SH HISTORY
61 POSIX.1-2001, C99.
62 .SH SEE ALSO
63 .BR strcpy (3),
64 .BR wcpcpy (3),
65 .BR wcscat (3),
66 .BR wcsdup (3),
67 .BR wmemcpy (3)