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
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.