WCSCASECMP(3) FreeBSD Library Functions Manual 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 IEEE Std 1003.1-2008 ("POSIX.1").
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 <
[email protected]>.
FreeBSD 14.1-RELEASE-p8 September 5, 2017 FreeBSD 14.1-RELEASE-p8