wcscoll(3)
NAME
- wcscoll - compare wide strings according to current colla
- tion
LIBRARY
Standard C Library (libc, -lc)
SYNOPSIS
#include <wchar.h> int wcscoll(const wchar_t *s1, const wchar_t *s2);
DESCRIPTION
- The wcscoll() function compares the null-terminated strings
- s1 and s2
according to the current locale collation order. In the - ``C'' locale,
wcscoll() is equivalent to wcscmp().
RETURN VALUES
- The wcscoll() function returns an integer greater than,
- equal to, or less
than 0, if s1 is greater than, equal to, or less than s2. - No return value is reserved to indicate errors; callers
- should set errno
to 0 before calling wcscoll(). If it is non-zero upon re - turn from
wcscoll(), an error has occurred.
ERRORS
The wcscoll() function will fail if:
- [EILSEQ] An invalid wide character code was speci
- fied.
- [ENOMEM] Cannot allocate enough memory for tempo
- rary buffers.
SEE ALSO
setlocale(3), strcoll(3), wcscmp(3), wcsxfrm(3)
STANDARDS
- The wcscoll() function conforms to ISO/IEC 9899:1999 (``ISO
- C99'').
BUGS
- The current implementation of wcscoll() only works in sin
- gle-byte
LC_CTYPE locales, and falls back to using wcscmp() in lo - cales with
extended character sets. - BSD October 4, 2002