Debian Codegraph @

upstream/debian-unstable/man3/wcsncat.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 wcsncat 3 2026-02-08 "Linux man-pages 6.18"
8 .SH NAME
9 wcsncat \- concatenate two wide-character strings
10 .SH LIBRARY
11 Standard C library
12 .RI ( libc ,\~ \-lc )
13 .SH SYNOPSIS
14 .nf
15 .B #include <wchar.h>
16 .P
17 .BR "wchar_t *wcsncat(" "size_t n;"
18 .BI " wchar_t *restrict " dest ,
19 .BI " const wchar_t " src "[restrict " n ],
20 .BI " size_t " n );
21 .fi
22 .SH DESCRIPTION
23 The
24 .BR wcsncat ()
25 function is the wide-character equivalent of the
26 .BR strncat (3)
27 function.
28 It copies at most
29 .I n
30 wide characters from the wide-character
31 string pointed to by
32 .I src
33 to the end of the wide-character string pointed
34 to by
35 .IR dest ,
36 and adds a terminating null wide character (L\[aq]\[rs]0\[aq]).
37 .P
38 The strings may not overlap.
39 .P
40 The programmer must ensure that there is room for at least
41 .IR wcslen(dest) + n +1
42 wide characters at
43 .IR dest .
44 .SH RETURN VALUE
45 .BR wcsncat ()
46 returns
47 .IR dest .
48 .SH ATTRIBUTES
49 For an explanation of the terms used in this section, see
50 .BR attributes (7).
51 .TS
52 allbox;
53 lbx lb lb
54 l l l.
55 Interface Attribute Value
56 T{
57 .na
58 .nh
59 .BR wcsncat ()
60 T} Thread safety MT-Safe
61 .TE
62 .SH STANDARDS
63 C11, POSIX.1-2008.
64 .SH HISTORY
65 POSIX.1-2001, C99.
66 .SH SEE ALSO
67 .BR strncat (3),
68 .BR wcscat (3)