]>
Commit | Line | Data |
---|---|---|
a1eaacb1 | 1 | '\" t |
fea681da MK |
2 | .\" Copyright (c) Bruno Haible <haible@clisp.cons.org> |
3 | .\" | |
e4a74ca8 | 4 | .\" SPDX-License-Identifier: GPL-2.0-or-later |
fea681da MK |
5 | .\" |
6 | .\" References consulted: | |
7 | .\" GNU glibc-2 source code and manual | |
8 | .\" Dinkumware C library reference http://www.dinkumware.com/ | |
008f1ecc | 9 | .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html |
fea681da | 10 | .\" |
4c1c5274 | 11 | .TH wcscasecmp 3 (date) "Linux man-pages (unreleased)" |
fea681da MK |
12 | .SH NAME |
13 | wcscasecmp \- compare two wide-character strings, ignoring case | |
f0110b69 AC |
14 | .SH LIBRARY |
15 | Standard C library | |
8fc3b2cf | 16 | .RI ( libc ", " \-lc ) |
fea681da MK |
17 | .SH SYNOPSIS |
18 | .nf | |
19 | .B #include <wchar.h> | |
68e4db0a | 20 | .PP |
fea681da MK |
21 | .BI "int wcscasecmp(const wchar_t *" s1 ", const wchar_t *" s2 ); |
22 | .fi | |
68e4db0a | 23 | .PP |
d39ad78f | 24 | .RS -4 |
df362fbf MK |
25 | Feature Test Macro Requirements for glibc (see |
26 | .BR feature_test_macros (7)): | |
d39ad78f | 27 | .RE |
68e4db0a | 28 | .PP |
df362fbf | 29 | .BR wcscasecmp (): |
9d2adbae MK |
30 | .nf |
31 | Since glibc 2.10: | |
5c10d2c5 | 32 | _POSIX_C_SOURCE >= 200809L |
9d2adbae MK |
33 | Before glibc 2.10: |
34 | _GNU_SOURCE | |
35 | .fi | |
fea681da | 36 | .SH DESCRIPTION |
60a90ecd MK |
37 | The |
38 | .BR wcscasecmp () | |
39 | function is the wide-character equivalent of the | |
40 | .BR strcasecmp (3) | |
41 | function. | |
c13182ef | 42 | It compares the wide-character string pointed to |
40aa0db0 MK |
43 | by |
44 | .I s1 | |
45 | and the wide-character string pointed to by | |
46 | .IR s2 , | |
47 | ignoring | |
60a90ecd MK |
48 | case differences |
49 | .RB ( towupper (3), | |
50 | .BR towlower (3)). | |
47297adb | 51 | .SH RETURN VALUE |
60a90ecd MK |
52 | The |
53 | .BR wcscasecmp () | |
54 | function returns zero if the wide-character strings at | |
40aa0db0 MK |
55 | .I s1 |
56 | and | |
57 | .I s2 | |
58 | are equal except for case distinctions. | |
c13182ef | 59 | It returns a |
40aa0db0 MK |
60 | positive integer if |
61 | .I s1 | |
62 | is greater than | |
63 | .IR s2 , | |
64 | ignoring case. | |
c13182ef | 65 | It |
40aa0db0 MK |
66 | returns a negative integer if |
67 | .I s1 | |
68 | is smaller | |
69 | than | |
70 | .IR s2 , | |
71 | ignoring case. | |
fde423dc | 72 | .SH ATTRIBUTES |
d37007bc PH |
73 | For an explanation of the terms used in this section, see |
74 | .BR attributes (7). | |
75 | .TS | |
76 | allbox; | |
c466875e | 77 | lbx lb lb |
d37007bc PH |
78 | l l l. |
79 | Interface Attribute Value | |
80 | T{ | |
9e54434e BR |
81 | .na |
82 | .nh | |
fde423dc | 83 | .BR wcscasecmp () |
d37007bc PH |
84 | T} Thread safety MT-Safe locale |
85 | .TE | |
c466875e | 86 | .sp 1 |
3113c7f3 | 87 | .SH STANDARDS |
21696186 | 88 | POSIX.1-2008. |
4131356c AC |
89 | .SH HISTORY |
90 | glibc 2.1. | |
fea681da | 91 | .SH NOTES |
d9bfdb9c | 92 | The behavior of |
60a90ecd | 93 | .BR wcscasecmp () |
1274071a MK |
94 | depends on the |
95 | .B LC_CTYPE | |
96 | category of the | |
fea681da | 97 | current locale. |
47297adb | 98 | .SH SEE ALSO |
e37e3282 MK |
99 | .BR strcasecmp (3), |
100 | .BR wcscmp (3) |