_strncoll, _wcsncoll, _mbsncoll

Compare strings using locale-specific information.

int _strncoll( const char *string1, const char *string2, size_t count );

int _wcsncoll( const wchar_t *string1, const wchar_t *string2, size_t count );

int _mbsncoll( const unsigned char *string1, const unsigned char *string2, size_t count );

Routine Required Header Compatibility
_strncoll <string.h> Win 95, Win NT
_wcsncoll <wchar.h> or <string.h> Win 95, Win NT
_mbsncoll <mbstring.h> Win 95, Win NT

For additional compatibility information, see Compatibility in the Introduction.

Libraries

LIBC.LIB Single thread static library, retail version
LIBCMT.LIB Multithread static library, retail version
MSVCRT.LIB Import library for MSVCRT.DLL, retail version

Return Value

Each of these functions returns a value indicating the relationship of the substrings of string1 and string2, as follows.

Return Value Relationship of string1 to string2
< 0 string1 less than string2
0 string1 identical to string2
> 0 string1 greater than string2

Each of these functions returns _NLSCMPERROR. To use _NLSCMPERROR, include either STRING.H or MBSTRING.H. _wcsncoll can fail if either string1 or string2 contains wide-character codes outside the domain of the collating sequence. When an error occurs, _wcsncoll may set errno to EINVAL. To check for an error on a call to _wcsncoll, set errno to 0 and then check errno after calling _wcsncoll.

Parameters

string1, string2

Null-terminated strings to compare

count

Number of characters to compare

Remarks

Each of these functions performs a case-sensitive comparison of the first count characters in string1 and string2 according to the code page currently in use. These functions should be used only when there is a difference between the character set order and the lexicographic character order in the current code page and this difference is of interest for the string comparison.

Generic-Text Routine Mappings

TCHAR.H Routine _UNICODE & _MBCS Not Defined _MBCS Defined _UNICODE Defined
_tcsnccoll _strncoll _mbsnbcoll _wcsncoll
_tcsncoll _strncoll _mbsnbcoll _wcsncoll

Locale Routines, String Manipulation Routinesstrcoll Functions Overview

See Also   localeconv, _mbsnbcoll, setlocale, strcmp, _stricmp, strncmp, _strnicmp, strxfrm