_strncoll, _wcsncoll, _mbsncoll

Compare strings using locale-specific information.

int_strncoll(constchar*string1,constchar*string2, size_tcount);

int_wcsncoll(constwchar_t*string1,constwchar_t*string2,size_tcount**);**

int_mbsncoll( constunsignedchar *string1**,constunsignedchar** *string2**,size_tcount);**

For additional compatibility information, see Compatibility in the Introduction.

Libraries

Return Value

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

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

Locale Routines, String Manipulation Routines |  strcoll Functions Overview

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