WCSCASECMP(3)

NAME
wcscasecmp, wcscasecmp_l, wcsncasecmp, wcsncasecmp_l - compare wide strings, ignoring case

SYNOPSIS
#include <wchar.h>
int
wcscasecmp(const wchar_t *s1, const wchar_t *s2);
int
wcscasecmp_l(const wchar_t *s1, const wchar_t *s2, locale_t locale);
int
wcsncasecmp(const wchar_t *s1, const wchar_t *s2, size_t len);
int
wcsncasecmp_l(const wchar_t *s1, const wchar_t *s2, size_t len, locale_t locale);

DESCRIPTION
These functions compare the wide strings s1 and s2 and return an integer greater than, equal to, or less than 0, according to whether s1 is lexicographically greater than, equal to, or less than s2 after translation of each corresponding wide character to lower case. The wide strings themselves are not modified.

For the translation to lower case, wcscasecmp() and wcsncasecmp() use the thread-specific locale as defined with uselocale(3), falling back to the global locale defined with setlocale(3). wcscasecmp_l() and wcsncasecmp_l() use the locale argument instead.

wcsncasecmp() and wcsncasecmp_l() compare at most len wide characters.

SEE ALSO
newlocale(3), setlocale(3), strcasecmp(3), wcscmp(3), wmemcmp(3)

STANDARDS
These functions conform to p1003.1-2008.

HISTORY
The wcscasecmp() and wcsncasecmp() functions have been available since OpenBSD 5.0, and wcscasecmp_l() and wcsncasecmp_l() since OpenBSD 6.2.

AUTHORS
The OpenBSD versions of wcscasecmp() and wcsncasecmp() were implemented by Marc Espie <espie@openbsd.org>.