_strnicmp, _wcsnicmp, _mbsnicmp, _strnicmp_l, _wcsnicmp_l, _mbsnicmp_l

比较两个字符串字符不考虑大小写。

重要

_mbsnicmp 和 _mbsnicmp_l 不能在 Windows 运行时执行的应用程序。有关更多信息,请参见 CRT 函数不支持与 /ZW

int _strnicmp(
   const char *string1,
   const char *string2,
   size_t count 
);
int _wcsnicmp(
   const wchar_t *string1,
   const wchar_t *string2,
   size_t count 
);
int _mbsnicmp(
   const unsigned char *string1,
   const unsigned char *string2,
   size_t count 
);
int _strnicmp_l(
   const char *string1,
   const char *string2,
   size_t count,
   _locale_t locale
);
int _wcsnicmp_l(
   const wchar_t *string1,
   const wchar_t *string2,
   size_t count,
   _locale_t locale
);
int _mbsnicmp_l(
   const unsigned char *string1,
   const unsigned char *string2,
   size_t count,
   _locale_t locale
);

参数

  • string1, string2
    比较的 null 终止的字符串。

  • count
    比较的字符数。

  • locale
    使用的区域设置。

返回值

指示子字符串之间的关系,如下所示。

返回值

描述

< 0

string1 子字符串比 string2 子字符串是小于。

0

string1 子字符串与 string2 子字符串是相同的。

> 0

string1 子字符串比 string2 子字符串大。

在错误,_mbsnicmp 返回 _NLSCMPERROR,在 STRING.H 和 MBSTRING.H. 定义。

备注

_strnicmp 功能字典地比较,至多,string1 第一 count 字符和 string2。 该执行比较不考虑大小写;_strnicmp 是 strncmp的一个不区分大小写的版本。 该比较结束,如果一个终止 null 字符在任何一个字符串为止,在 count 字符进行比较之前。 如果字符串相等,在一个终止 null 字符在任何一个字符串时为止,在 count 字符进行比较之前,较短的字符串小于。

从 91 到 96 的 ASCII 字符的表 (“[”,“\”,“]”,“^”,“_”,“和“”) 的所有字母都计算为更少。 保留的这与相同的 stricmp。

_wcsnicmp 和 _mbsnicmp 是 _strnicmp的宽字符和多字节字符版本。 参数和返回 _wcsnicmp 的值是宽字符字符串;这些 _mbsnicmp 的多字节字符字符串。 _mbsnicmp 根据当前多字节代码页识别多字节字符序列并返回该错误的 _NLSCMPERROR。 有关更多信息,请参见代码页。 这三个功能否则具有相同的行为。 这些功能是受没有 _l 后缀使用这些区域设置相关的行为的当前区域设置区域设置的此版本的影响;将 _l 后缀使用区域设置传递的版本。 有关更多信息,请参见区域设置

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

一般文本例程映射

TCHAR.H 实例

未定义的_UNICODE & _MBCS

定义的_MBCS

定义的_UNICODE

_tcsncicmp

_strnicmp

_mbsnicmp

_wcsnicmp

_tcsnicmp

_strnicmp

_mbsnbicmp

_wcsnicmp

_tcsncicmp_l

_strnicmp_l

_mbsnicmp_l

_wcsnicmp_l

要求

实例

必需的标头

_strnicmp, _strnicmp_l

<string.h>

_wcsnicmp, _wcsnicmp_l

<string.h> 或 <wchar.h>

_mbsnicmp, _mbsnicmp_l

<mbstring.h>

有关其他的兼容性信息,请参见 兼容性

示例

strncmp参见示例。

.NET Framework 等效项

System::String::Compare

请参见

参考

字符串操作(crt)

strcat, wcscat, _mbscat

strcmp, wcscmp, _mbscmp

strcpy, wcscpy, _mbscpy

strncat, _strncat_l, wcsncat, wcsncat_l, _mbsncat _mbsncat_l

strncmp, wcsncmp, _mbsncmp, _mbsncmp_l

strncpy, _strncpy_l, wcsncpy, _wcsncpy_l, _mbsncpy, _mbsncpy_l

strrchr, wcsrchr, _mbsrchr, _mbsrchr_l

_strset, _strset_l, _wcsset, _wcsset_l, _mbsset, _mbsset_l

strspn, wcsspn, _mbsspn, _mbsspn_l