]> git.ipfire.org Git - thirdparty/man-pages.git/blame - man3/wcscasecmp.3
ffix
[thirdparty/man-pages.git] / man3 / wcscasecmp.3
CommitLineData
fea681da
MK
1.\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
2.\"
3.\" This is free documentation; you can redistribute it and/or
4.\" modify it under the terms of the GNU General Public License as
5.\" published by the Free Software Foundation; either version 2 of
6.\" the License, or (at your option) any later version.
7.\"
8.\" References consulted:
9.\" GNU glibc-2 source code and manual
10.\" Dinkumware C library reference http://www.dinkumware.com/
11.\" OpenGroup's Single Unix specification http://www.UNIX-systems.org/online.html
12.\"
13.TH WCSCASECMP 3 1999-07-25 "GNU" "Linux Programmer's Manual"
14.SH NAME
15wcscasecmp \- compare two wide-character strings, ignoring case
16.SH SYNOPSIS
17.nf
18.B #include <wchar.h>
19.sp
20.BI "int wcscasecmp(const wchar_t *" s1 ", const wchar_t *" s2 );
21.fi
22.SH DESCRIPTION
60a90ecd
MK
23The
24.BR wcscasecmp ()
25function is the wide-character equivalent of the
26.BR strcasecmp (3)
27function.
c13182ef 28It compares the wide-character string pointed to
fea681da 29by \fIs1\fP and the wide-character string pointed to by \fIs2\fP, ignoring
60a90ecd
MK
30case differences
31.RB ( towupper (3),
32.BR towlower (3)).
fea681da 33.SH "RETURN VALUE"
60a90ecd
MK
34The
35.BR wcscasecmp ()
36function returns zero if the wide-character strings at
c13182ef
MK
37\fIs1\fP and \fIs2\fP are equal except for case distinctions.
38It returns a
39positive integer if \fIs1\fP is greater than \fIs2\fP, ignoring case.
40It
41returns a negative integer if \fIs1\fP is smaller
42than \fIs2\fP, ignoring case.
fea681da
MK
43.SH "CONFORMING TO"
44This function is a GNU extension.
fea681da 45.SH NOTES
d9bfdb9c 46The behavior of
60a90ecd
MK
47.BR wcscasecmp ()
48depends on the LC_CTYPE category of the
fea681da 49current locale.
e37e3282
MK
50.SH "SEE ALSO"
51.BR strcasecmp (3),
52.BR wcscmp (3)