wcscoll3
Compare wide strings according to current collation
Usage
#include <wchar.h>
int
wcscoll(const wchar_t *s1, const wchar_t *s2);
Library
Standard C Library (libc, -lc)
Overview
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 return from wcscoll(), an error has occurred.
Errors
The wcscoll() function will fail if:
- [EILSEQ]
-
An invalid wide character code was specified.
- [ENOMEM]
-
Cannot allocate enough memory for temporary buffers.
Releases
56 releases since FreeBSD 5.0-RELEASE; the text changed 33 times.