Debian Codegraph @

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