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(), strcasemp_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").

OmniOS April 9, 2016 OmniOS