_mbsnbicmp, _mbsnbicmp_l

比较 n 字节两个多字节字符字符串,将忽略大小写。

重要

此 API 不能在运行时的窗口执行的应用程序。有关更多信息,请参见 CRT 函数不支持与 /ZW

int _mbsnbicmp(
   const unsigned char *string1,
   const unsigned char *string2,
   size_t count 
);

参数

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

  • count
    比较的字节数。

返回值

返回值指示子字符串之间的关系。

返回值

描述

< 0

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

0

string1 子字符串与 string2 子字符串。

> 0

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

在错误,_mbsnbcmp 返回 _NLSCMPERROR,在 String.h 和 Mbstring.h 中定义。

备注

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

_mbsnbicmp类似于 _mbsnicmp,除此之外,由字节比较字符串而不是按字符。

包含字符的两个字符串驻留在“Z”和" a "之间”在 ASCII 表 (“[”,“\”,“]”,“^”,“_”,“和“”) 基于它们的大小写不同地比较。 例如,两个字符串“ABCDE”和“ABCD^”比较一种方法,则此比较是例 ("abcde”>“abcd^") 和另一种方法 ("ABCDE”<“ABCD^"),则大写。

_mbsnbicmp根据当前正在使用的 多字节代码页 识别多字节字符序列。 它不影响的受当前区域设置的。

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

一般文本例程映射

Tchar.h 实例

未定义的_UNICODE 和_MBCS

定义的_MBCS

定义的_UNICODE

_tcsnicmp

_strnicmp

_mbsnbicmp

_wcsnicmp

_tcsnicmp_l

_strnicmp_l

_mbsnbicmp_l

_wcsnicmp_l

要求

实例

必需的标头

_mbsnbicmp

<mbstring.h>

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

示例

_mbsnbcmp, _mbsnbcmp_l参见示例。

.NET Framework 等效项

不适用。若要调用标准 C 函数,请使用 PInvoke。有关更多信息,请参见 平台调用示例

请参见

参考

字符串操作(crt)

_mbsnbcat, _mbsnbcat_l

_mbsnbcmp, _mbsnbcmp_l

_stricmp, _wcsicmp, _mbsicmp, _stricmp_l, _wcsicmp_l, _mbsicmp_l