_mbsbtype, _mbsbtype_l

返回字节的类型在字符串中。

重要

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

int _mbsbtype(
   const unsigned char *mbstr,
   size_t count 
);
int _mbsbtype_l(
   const unsigned char *mbstr,
   size_t count,
   _locale_t locale 
);

参数

  • mbstr
    多字节字符序列的地址。

  • count
    从字符串的开头的字节偏移量。

  • locale
    使用的区域设置。

返回值

_mbsbtype 和 _mbsbtype_l返回指示测试的结果在指定的字节的整数值。 清单常数在下表中 Mbctype.h 定义。

返回值

字节类型

_MBC_SINGLE (0)

单字节字符。 例如,在代码页 932,_mbsbtype 返回 0;如果指定的字节在范围内 0x20 – 0x7E 或 0xA1 – 0xDF。

_MBC_LEAD (1)

前导字节多字节字符。 例如,在代码页 932,_mbsbtype 返回 1;如果指定的字节范围在 0x81 中– 0x9F 或 0xE0 – 0xFC。

_MBC_TRAIL (2)

尾随字节多字节字符。 例如,在代码页 932,_mbsbtype 返回 2;如果指定的字节范围在 0x40 中– 0x7E 或 0x80 – 0xFC。

_MBC_ILLEGAL (–1)

NULL 字符串、无效字符或在字节之前找到的 NULL 字节在 mbstr的偏移量 count。

备注

_mbsbtype 函数确定一个字节的类型在多字节字符字符串的。 函数只检查该字节在 mbstr的偏移量 count,忽略无效字符在指定的字节之前。

输出值受设置 LC_CTYPE 类设置的影响区域设置;请参见 setlocale 有关更多信息。 此功能的版本不 _l 后缀为该区域设置相关的行为使用当前区域设置;与 _l 后缀的版本与相同,但它区域设置参数传递的使用。 有关更多信息,请参见区域设置

如果输入字符串是 NULL,无效参数调用处理程序,如 参数验证所述。 如果执行允许继续,errno 设置为 EINVAL,函数返回 _MBC_ILLEGAL。

要求

实例

必需的标头

选项标头

_mbsbtype

<mbstring.h>

<mbctype.h>*

_mbsbtype_l

<mbstring.h>

<mbctype.h>*

*要使用的清单常数返回值。

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

.NET Framework 等效项

不适用,但是,请参见 System::Globalization::CultureInfo

请参见

参考

字节类别