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
wcsncasecmp(const wchar_t *s1, const wchar_t *s2, size_t len);
#include <xlocale.h>
int
wcscasecmp_l(const wchar_t *s1, const wchar_t *s2, locale_t l);
int
wcsncasecmp_l(const wchar_t *s1, const wchar_t *s2, size_t len, locale_t l);

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.

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

The behavior of the functions wcscasecmp() and wcsncasecmp() is affected by the LC_CTYPE category of the current locale, while the behavior of the functions wcscasecmp_l() and wcsncasecmp_l() is affected by the LC_CTYPE category of the locale provided as parameter, see xlocale(3).

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

STANDARDS
The wcscasecmp() and wcsncasecmp() functions conform to POSIX 2008 , p1003.1-2008.

HISTORY
The wcscasecmp() and wcsncasecmp() functions first appeared in OpenBSD 5.0.

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