October 13, 2006 WCSCOLL 3

### NAME

wcscoll - compare wide strings according to current collation

### LIBRARY

Standard C Library (libc, -lc)

### SYNOPSIS

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

### DESCRIPTION

The wcscoll(``) function compares the nul-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.

### 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(``) function disregards ```LC_COLLATE` locales, and falls back to using the wcscmp(``) function.