Debian Codegraph @

upstream/debian-trixie/man3/wcscpy.3

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