_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。有关更多信息,请参见 平台调用示例。
请参见
参考
_stricmp, _wcsicmp, _mbsicmp, _stricmp_l, _wcsicmp_l, _mbsicmp_l