wcscoll()

Updated: April 19, 2023

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

Safety:  
Cancellation point No
Interrupt handler No
Signal handler Yes
Thread No