WCSCASECMP(3) | 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 <espie@openbsd.org>.

September 5, 2017 | Debian