_stricoll、_wcsicoll、_mbsicoll、_stricoll_l、_wcsicoll_l、_mbsicoll_l

项目
06/09/2015

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

重要

_mbsicoll 和 _mbsicoll_l 不能在 Windows 运行时执行的应用程序中使用。有关详细信息，请参见 CRT functions not supported with /ZW（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。

一般文本例程映射