Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Compare strings using locale-specific information.
int_strnicoll(constchar*string1,constchar*string2,size_tcount**);**
int_wcsnicoll(constwchar_t*string1,constwchar_t*string2,size_tcount**);**
int_mbsnicoll( constunsignedchar *string1**,constunsignedchar** *string2**,size_tcount);**
| Routine | Required Header | Compatibility |
| _strnicoll | <string.h> | Win 95, Win NT |
| _wcsnicoll | <wchar.h> or <string.h> | Win 95, Win NT |
| _mbsnicoll | <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. _wcsnicoll can fail if either string1 or string2 contains wide-character codes outside the domain of the collating sequence. When an error occurs, _wcsnicoll may set errno to EINVAL. To check for an error on a call to _wcsnicoll, set errno to 0 and then check errno after calling _wcsnicoll.
Parameters
string1, string2
Null-terminated strings to compare
count
Number of characters to compare
Remarks
Each of these functions performs a case-insensitive 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 |
| _tcsncicoll | _strnicoll | _mbsnbicoll | _wcsnicoll |
| _tcsnicoll | _strnicoll | _mbsnbicoll | _wcsnicoll |
Locale Routines | String Manipulation Routines | strcoll Functions Overview
See Also localeconv, _mbsnbcoll, setlocale, strcmp, _stricmp, strncmp, _strnicmp, strxfrm