WCSCASECMP(3C) Standard C Library Functions WCSCASECMP(3C)
NAME
wcscasecmp,
wcscasecmp_l,
wcsncasecmp,
wcsncasecmp_l - case-insensitive
wide-character string comparison
SYNOPSIS
#include <wchar.h> int wcscasecmp(
const wchar_t *ws1,
const wchar_t *ws2);
int wcscasecmp_l(
const wchar_t *ws1,
const wchar_t *ws2,
locale_t loc);
int wcsncasecmp(
const wchar_t *ws1,
const wchar_t *ws2,
size_t n);
int wcsncasecmp_l(
const wchar_t *ws1,
const wchar_t *ws2,
size_t n,
locale_t loc);
DESCRIPTION
These functions perform case-insensitive comparison of wide-character
strings
ws1 and
ws2. Pairs of wide-characters from each of
ws1 and
ws2 are compared consecutively, ignoring differences in case (if the
"POSIX" locale upper case characters are treated as lower case). If
the two values are different, the comparison stops and either a
negative value is returned if the character from
ws1 is less than that
from
ws2, or a positive is returned if the character from
ws1 is
greater than that from
ws2. The comparison also stops if both
characters are null wide-characters, or, in the case of
wcsncasecmp()
and
wcsncasecmp_l(), after
n comparisons have been made without finding
a difference. In either of these two cases, 0 is returned.
The
wcscasecmp() and
wcsncasecmp() functions use the LC_CTYPE category
of the current locale to determine case. The
wcscasecmp_l() and
wcsncasecmp_l() functions use the LC_CTYPE category of the locale
pointed to by
loc to determine case.
Passing LC_GLOBAL_LOCALE for
loc results in undefined behavior.
The
wcscasecmp(),
wcsncasecmp(),
wcscasecmp_l(), and
wcsncasecmp_l()
functions are the wide-character equivalents of the
strcasecmp(),
strncasecmp(),
strcasecmp_l(), and
strncasecmp_l() functions,
respectively.
RETURN VALUES
These functions return a negative value if, ignoring case,
ws1 is less
than
ws1, or a positive value if
ws1 is greater than
ws2, or 0 if the
both
ws1 and
ws2 are the same.
ERRORS
None.
INTERFACE STABILITY
Standard.
MT-LEVEL MT-Safe.
SEE ALSO
newlocale(3C),
setlocale(3C),
strcasecmp(3C),
strcasecmp_l(3C),
strncasecmp(3C),
strncasecmp_l(3C),
uselocale(3C),
wchar.h(3HEAD),
locale(7),
standards(7)STANDARDS
The
wcscasecmp(),
wcsncasecmp(),
wcscasecmp_l(), and
wcsncasecmp_l()
functions were introduced in IEEE Std 1003.1-2008 ("POSIX.1").
illumos February 17, 2023 illumos
