wcscoll
- compare wide strings according to current collation
LIBRARY
Lb libc
SYNOPSIS
#include <wchar.h> int
wcscoll (const wchar_t *s1 const wchar_t *s2);
DESCRIPTION
The
wcscoll ();
function compares the null-terminated strings
Fa s1
and
Fa s2
according to the current locale collation order.
#include <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
Fa s1
is greater than, equal to, or less than
Fa s2 .
No return value is reserved to indicate errors;
callers should set
errno
to 0 before calling
wcscoll (.);
If it is non-zero upon return from
wcscoll (,);
an error has occurred.
ERRORS
The
wcscoll ();
function will fail if:
Bq Er EILSEQ
An invalid wide character code was specified.
Bq Er ENOMEM
Cannot allocate enough memory for temporary buffers.
The
wcscoll ();
function
conforms to
St -isoC-99 .
BUGS
The current implementation of
wcscoll ();
only works in single-byte
LC_CTYPE
locales, and falls back to using
wcscmp ();
in locales with extended character sets.
