_strnicoll、_wcsnicoll、_mbsnicoll、_strnicoll_l、_wcsnicoll_l、_mbsnicoll_l

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

重要

_mbsnicoll 和 _mbsnicoll_l 不能在 Windows 运行时的应用程序中使用。有关详细信息,请参见 CRT functions not supported with /ZW(CRT 函数不支持使用/ZW)。

int _strnicoll(
   const char *string1,
   const char *string2,
   size_t count 
);
int _wcsnicoll(
   const wchar_t *string1,
   const wchar_t *string2 ,
   size_t count 
);
int _mbsnicoll(
   const unsigned char *string1,
   const unsigned char *string2,
   size_t count 
);
int _strnicoll_l(
   const char *string1,
   const char *string2,
   size_t count,
   _locale_t locale
);
int _wcsnicoll_l(
   const wchar_t *string1,
   const wchar_t *string2 ,
   size_t count,
   _locale_t locale
);
int _mbsnicoll_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 包含排序序列的字段之外的宽字符代码,_wcsnicoll 会失败。 发生错误时,_wcsnicoll 可以将 errno 设置为 EINVAL。 为检查调用_wcsnicoll发生的错误,设置 errno 为0, 然后在调用 _wcsnicoll**.**后,检查 errno。

备注

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

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

一般文本例程映射

TCHAR.H 例程

未定义 _UNICODE & _MBCS

已定义 _MBCS

已定义 _UNICODE

_tcsncicoll

_strnicoll

_mbsnbicoll

_wcsnicoll

_tcsnicoll

_strnicoll

_mbsnbicoll

_wcsnicoll

_tcsnicoll_l

_strnicoll_l

_mbsnbicoll_l

_wcsnicoll_l

要求

例程

必需的标头

_strnicoll, _strnicoll_l

<string.h>

_wcsnicoll, _wcsnicoll_l

<wchar.h> 或 <string.h>

_mbsnicoll, _mbsnicoll_l

<mbstring.h>

有关兼容性的更多信息,请参见兼容性

.NET Framework 等效项

System::String::Compare

请参见

参考

区域设置

字符串操作 (CRT)

strcoll 函数

localeconv

_mbsnbcoll、_mbsnbcoll_l、_mbsnbicoll、_mbsnbicoll_l

setlocale、_wsetlocale

strcmp、wcscmp、_mbscmp

_stricmp、_wcsicmp、_mbsicmp、_stricmp_l、_wcsicmp_l、_mbsicmp_l

strncmp、wcsncmp、_mbsncmp、_mbsncmp_l

_strnicmp、_wcsnicmp、_mbsnicmp、_strnicmp_l、_wcsnicmp_l、_mbsnicmp_l

strxfrm、wcsxfrm、_strxfrm_l、_wcsxfrm_l