wcscoll()

compare two wide character strings using LC_COLLATE 

Function

SYNOPSIS

#include <wchar.h>

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

DESCRIPTION

The wcscoll() function is used to compare the wide character string pointed to by ws1 to the wide character string pointed to by ws2. This function is identical to the wcscmp() function because LC_COLLATE is unimplemented, hence the locale is always "C".

PARAMETERS

ws1 

Is a null-terminated string to compare.

ws2 

Is a null-terminated string to compare.

RETURN VALUES

The wcscoll() function returns a positive integer if ws1 is greater than ws2, zero if ws1 equals ws2, and a negative integer if ws1 is less than ws2.

CONFORMANCE

ANSI/ISO 9899-1990/AM 1-1995.

MULTITHREAD SAFETY LEVEL

MT-Safe, with exceptions.

This function is MT-Safe as long as no thread calls setlocale() while this function is executing.

PORTING ISSUES

None.

AVAILABILITY

MKS Toolkit for Professional Developers
MKS Toolkit for Enterprise Developers
MKS Toolkit for Enterprise Developers 64-Bit Edition

SEE ALSO

Functions:
wcscmp(), wcsncmp(), wcsxfrm()

MKS Toolkit 9.2 Documentation Build 16.