WCSCOLL(3) | Library Functions Manual | WCSCOLL(3)

# NAME

`wcscoll`, `wcscoll_l` — compare wide strings according to the current collation

# SYNOPSIS

`#include <wchar.h>`

int
`wcscoll`(const wchar_t *s1, const wchar_t *s2);

int
`wcscoll_l`(const wchar_t *s1, const wchar_t *s2, locale_t locale);

# DESCRIPTION

The `wcscoll`() and `wcscoll_l`() functions lexicographically compare the NUL-terminated wide strings s1 and s2 according to the current locale collation and return an integer greater than, equal to, or less than 0, according to whether s1 is greater than, equal to, or less than s2.

On OpenBSD, they have the same effect as wcscmp(3), and the global locale, the thread-specific locale, and the locale argument are ignored. On other operating systems, the results may depend on the `LC_CTYPE` and `LC_COLLATE` locale categories set with setlocale(3), uselocale(3), or newlocale(3).

# SEE ALSO

newlocale(3), setlocale(3), wcscmp(3), wcsxfrm(3)

# STANDARDS

The `wcscoll`() function conforms to ISO/IEC 9899:1999 (“ISO C99”), and `wcscoll_l`() to IEEE Std 1003.1-2008 (“POSIX.1”).

# HISTORY

The `wcscoll`() function has been available since OpenBSD 4.8, and `wcscoll_l`() since OpenBSD 6.2.

January 18, 2019 | Debian