This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

wcscoll()

Compare two wide-character strings, using the locale's collating sequence

Synopsis:

#include <wchar.h>

int wcscoll( const wchar_t * ws1,
             const wchar_t * ws2 );

Arguments:

ws1, ws2

The wide-character strings that you want to compare.

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

Description:

The wcscoll() function compares the wide-character strings pointed to by ws1 and ws2, using the LC_COLLATE collating sequence selected by the setlocale() function.

Returns:

< 0

ws1 is less than ws2.

0

ws1 is equal to ws2.

> 0

ws1 is greater than ws2.

Classification:

ANSI, POSIX 1003.1

wcscoll()

See also:

setlocale(), strcasecmp(), strcmp(), strcmpi(), strcoll(), stricmp(), strncasecmp(), strncmp(), strnicmp(), wcscmp(), wcsncmp()