Debian Codegraph @

upstream/debian-trixie/man3/wcscasecmp.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 .\"
11 .TH wcscasecmp 3 2024-05-02 "Linux man-pages 6.9.1"
12 .SH NAME
13 wcscasecmp \- compare two wide-character strings, ignoring case
14 .SH LIBRARY
15 Standard C library
16 .RI ( libc ", " \-lc )
17 .SH SYNOPSIS
18 .nf
19 .B #include <wchar.h>
20 .P
21 .BI "int wcscasecmp(const wchar_t *" s1 ", const wchar_t *" s2 );
22 .fi
23 .P
24 .RS -4
25 Feature Test Macro Requirements for glibc (see
26 .BR feature_test_macros (7)):
27 .RE
28 .P
29 .BR wcscasecmp ():
30 .nf
31 Since glibc 2.10:
32 _POSIX_C_SOURCE >= 200809L
33 Before glibc 2.10:
34 _GNU_SOURCE
35 .fi
36 .SH DESCRIPTION
37 The
38 .BR wcscasecmp ()
39 function is the wide-character equivalent of the
40 .BR strcasecmp (3)
41 function.
42 It compares the wide-character string pointed to
43 by
44 .I s1
45 and the wide-character string pointed to by
46 .IR s2 ,
47 ignoring
48 case differences
49 .RB ( towupper (3),
50 .BR towlower (3)).
51 .SH RETURN VALUE
52 The
53 .BR wcscasecmp ()
54 function returns zero if the wide-character strings at
55 .I s1
56 and
57 .I s2
58 are equal except for case distinctions.
59 It returns a
60 positive integer if
61 .I s1
62 is greater than
63 .IR s2 ,
64 ignoring case.
65 It
66 returns a negative integer if
67 .I s1
68 is smaller
69 than
70 .IR s2 ,
71 ignoring case.
72 .SH ATTRIBUTES
73 For an explanation of the terms used in this section, see
74 .BR attributes (7).
75 .TS
76 allbox;
77 lbx lb lb
78 l l l.
79 Interface Attribute Value
80 T{
81 .na
82 .nh
83 .BR wcscasecmp ()
84 T} Thread safety MT-Safe locale
85 .TE
86 .SH STANDARDS
87 POSIX.1-2008.
88 .SH HISTORY
89 glibc 2.1.
90 .SH NOTES
91 The behavior of
92 .BR wcscasecmp ()
93 depends on the
94 .B LC_CTYPE
95 category of the
96 current locale.
97 .SH SEE ALSO
98 .BR strcasecmp (3),
99 .BR wcscmp (3)