_strncoll、_wcsncoll、_mbsncoll、_strncoll_l、_wcsncoll_l、_mbsncoll_l

项目
06/09/2015

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

重要

_mbsncoll 和 _mbsncoll_l 不能用于在 Windows 运行时. 中执行应用程序。有关更多信息，请参见不支持 /ZW 的 CRT 函数。

int _strncoll(
   const char *string1,
   const char *string2,
   size_t count 
);
int _wcsncoll(
   const wchar_t *string1,
   const wchar_t *string2,
   size_t count 
);
int _mbsncoll(
   const unsigned char *string1,
   const unsigned char *string2,
   size_t count 
);
int _strncoll_l(
   const char *string1,
   const char *string2,
   size_t count,
   _locale_t locale
);
int _wcsncoll_l(
   const wchar_t *string1,
   const wchar_t *string2,
   size_t count,
   _locale_t locale
);
int _mbsncoll_l(
   const unsigned char *string1,
   const unsigned char *string2,
   size_t count,
   _locale_t locale
);

参数

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

返回值

这些函数都返回一个指示 string1 和 string2子字符串关系的值，如下所示。

返回值	string1 与 string2 的关系
< 0	string1 小于 string2。
0	string1 等同于 string2。
> 0	string1 大于 string2。

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

备注

每一个这些函数在 string1 和 string2中，根据当前使用的代码页执行首个 count 字符的区分大小写的比较。只有当对字符集排序时和代码页中字典字符的排序不同，并且字符串比较时产生不同利益时，才应使用这些功能。字符集顺序与区域设置相关。没有 _l 后缀使用当前这些区域设置函数的版本，但是将 _l 后缀使用区域设置将的版本。有关详细信息，请参阅区域设置。

所有这些函数都验证其参数。如果 string1 或 string2 是 null 指针，或者，如果 count 比 INT_MAX大，无效参数调用处理程序，如参数验证所述。如果允许执行继续，则这些函数返回 _NLSCMPERROR 并将 errno 设置为 EINVAL。

一般文本例程映射