strcoll、wcscoll、_mbscoll、_strcoll_l、_wcscoll_l、_mbscoll_l

项目
06/09/2015

使用当前区域设置或指定的 LC_COLLATE 转换状态类别，比较字符串。

重要

_mbscoll 和 _mbscoll_l 不能在 Windows 运行时执行的应用程序中使用。有关详细信息，请参见 CRT functions not supported with /ZW（CRT 函数不支持使用/ZW）。

int strcoll(
   const char *string1,
   const char *string2 
);
int wcscoll(
   const wchar_t *string1,
   const wchar_t *string2 
);
int _mbscoll(
   const unsigned char *string1,
   const unsigned char *string2 
);
int _strcoll_l(
   const char *string1,
   const char *string2,
   _locale_t locale 
);
int wcscoll_l(
   const wchar_t *string1,
   const wchar_t *string2,
   _locale_t locale 
);
int _mbscoll_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，请包括 STRING.H 或 MBSTRING.H。如果 string1 或 string2 包含排序序列的字段之外的宽字符代码，wcscoll 会失败。发生错误时，wcscoll 可以将 errno 设置为 EINVAL。为检查调用wcscoll发生的错误，设置errno 为0，然后在调用wcscoll后检查 errno。