aboutsummaryrefslogtreecommitdiffstats
path: root/man/man3/wcscasecmp.3
diff options
context:
space:
mode:
Diffstat (limited to 'man/man3/wcscasecmp.3')
-rw-r--r--man/man3/wcscasecmp.346
1 files changed, 28 insertions, 18 deletions
diff --git a/man/man3/wcscasecmp.3 b/man/man3/wcscasecmp.3
index 88d88b2a3d..b696158ded 100644
--- a/man/man3/wcscasecmp.3
+++ b/man/man3/wcscasecmp.3
@@ -10,7 +10,10 @@
.\"
.TH wcscasecmp 3 (date) "Linux man-pages (unreleased)"
.SH NAME
-wcscasecmp \- compare two wide-character strings, ignoring case
+wcscasecmp,
+wcsncasecmp
+\-
+compare two wide-character strings, ignoring case
.SH LIBRARY
Standard C library
.RI ( libc ", " \-lc )
@@ -19,6 +22,8 @@ Standard C library
.B #include <wchar.h>
.P
.BI "int wcscasecmp(const wchar_t *" s1 ", const wchar_t *" s2 );
+.BI "int wcsncasecmp(const wchar_t " s1 [. n "], const wchar_t " s2 [. n "], \
+size_t " n );
.fi
.P
.RS -4
@@ -26,7 +31,8 @@ Feature Test Macro Requirements for glibc (see
.BR feature_test_macros (7)):
.RE
.P
-.BR wcscasecmp ():
+.BR wcscasecmp (),
+.BR wcsncasecmp ():
.nf
Since glibc 2.10:
_POSIX_C_SOURCE >= 200809L
@@ -48,27 +54,30 @@ ignoring
case differences
.RB ( towupper (3),
.BR towlower (3)).
+.P
+The
+.BR wcsncasecmp ()
+function is similar
+(the wide-character equivalent of
+.BR strncasecmp (3)),
+except that it compares no more than
+.I n
+wide characters of
+.I s1
+and
+.IR s2 .
.SH RETURN VALUE
The
.BR wcscasecmp ()
-function returns zero if the wide-character strings at
-.I s1
and
-.I s2
-are equal except for case distinctions.
-It returns a
-positive integer if
-.I s1
-is greater than
-.IR s2 ,
-ignoring case.
-It
-returns a negative integer if
+.BR wcsncasecmp ()
+functions return
+an integer less than, equal to, or greater than zero if
.I s1
-is smaller
-than
+is, after ignoring case, found to be
+less than, to match, or be greater than
.IR s2 ,
-ignoring case.
+respectively.
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
.BR attributes (7).
@@ -80,7 +89,8 @@ Interface Attribute Value
T{
.na
.nh
-.BR wcscasecmp ()
+.BR wcscasecmp (),
+.BR wcsncasecmp ()
T} Thread safety MT-Safe locale
.TE
.SH STANDARDS