Debian Codegraph @

upstream/debian-trixie/man3/wcslen.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 wcslen 3 2024-06-15 "Linux man-pages 6.9.1"
13 .SH NAME
14 wcslen \- determine the length of 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 "size_t wcslen(const wchar_t *" s );
23 .fi
24 .SH DESCRIPTION
25 The
26 .BR wcslen ()
27 function is the wide-character equivalent
28 of the
29 .BR strlen (3)
30 function.
31 It determines the length of the wide-character string pointed to
32 by
33 .IR s ,
34 excluding the terminating null wide character (L\[aq]\[rs]0\[aq]).
35 .SH RETURN VALUE
36 The
37 .BR wcslen ()
38 function returns the
39 number of wide characters in
40 .IR s .
41 .SH ATTRIBUTES
42 For an explanation of the terms used in this section, see
43 .BR attributes (7).
44 .TS
45 allbox;
46 lbx lb lb
47 l l l.
48 Interface Attribute Value
49 T{
50 .na
51 .nh
52 .BR wcslen ()
53 T} Thread safety MT-Safe
54 .TE
55 .SH STANDARDS
56 C11, POSIX.1-2008.
57 .SH HISTORY
58 POSIX.1-2001, C99.
59 .SH NOTES
60 In cases where the input buffer may not contain
61 a terminating null wide character,
62 .BR wcsnlen (3)
63 should be used instead.
64 .SH SEE ALSO
65 .BR strlen (3)