_stricoll， _wcsicoll， _mbsicoll， _stricoll_l， _wcsicoll_l， _mbsicoll_l

项目
04/10/2013

使用特定于区域设置的信息，比较字符串。

重要

_mbsicoll 和 _mbsicoll_l 不能在运行时的窗口执行的应用程序。有关更多信息，请参见 CRT 函数不支持与 /ZW。

int _stricoll(
   const char *string1,
   const char *string2 
);
int _wcsicoll(
   const wchar_t *string1,
   const wchar_t *string2 
);
int _mbsicoll(
   const unsigned char *string1,
   const unsigned char *string2 
);
int _stricoll_l(
   const char *string1,
   const char *string2,
   _locale_t locale
);
int _wcsicoll_l(
   const wchar_t *string1,
   const wchar_t *string2,
   _locale_t locale
);
int _mbsicoll_l(
   const unsigned char *string1,
   const unsigned char *string2,
   _locale_t locale
);

参数

string1, string2
比较的 null 终止的字符串。
locale
使用的区域设置。

返回值

这些函数都返回一个指示 string1 的关系值设置为 string2*，* 如下所示。

返回值	string1 关系 string2
< 0	string1 小于 string2
0	string1 与 string2
> 0	string1 大于 string2
_NLSCMPERROR	发生错误。

这些函数都返回一个 _NLSCMPERROR。若要使用 _NLSCMPERROR，请包括 STRING.H 或 MBSTRING.H。如果 string1 或 string2 包含一个排序的序列的字段之外，宽字符代码_wcsicoll 会失败。发生错误时，_wcsicoll 可以设置 errno 到 EINVAL。若要检查调用一个错误。_wcsicoll，请设置 errno 到 0 在调用 _wcsicoll然后检查 errno。

备注

这些功能中的每一个基于当前正在使用的代码页执行 string1 和 string2 一个不区分大小写的比较。应使用这些功能，只有 + 当对字符集命令时和字典字符序列当前代码页和差异之间的区别是字符串比较的利益。

_stricmp 与 _stricoll 的不同之处在于 _stricmp 比较受 LC_CTYPE的影响，而 _stricoll 比较是基于区域设置的 LC_CTYPE 和 LC_COLLATE 类别。有关 LC_COLLATE 类别的更多信息，请参见 setlocale 和区域设置类别。这些功能的版本不 _l 后缀使用当前的区域设置；与 _l 后缀的版本相同，只不过它们使用的区域设置。有关更多信息，请参见区域设置。

所有这些函数验证其参数。如果 string1 或 string2 是 NULL 指针，无效参数调用处理程序，如参数验证所述。如果执行允许继续，这些函数返回 _NLSCMPERROR 并将 errno 到 EINVAL。

一般文本例程映射