_mbclen、mblen、_mblen_l

项目
06/09/2015

获取该长度并确定多字节字符的有效性。

重要

此 API 不能用于在 Windows 运行时中执行的应用程序。有关详细信息，请参见 CRT functions not supported with /ZW（CRT 函数不支持使用/ZW）。

size_t _mbclen(
   const unsigned char *c 
);
int mblen(
   const char *mbstr,
   size_t count 
);
int _mblen_l(
   const char *mbstr,
   size_t count,
   _locale_t locale
);

参数

c
多字节字符
mbstr
多字节字符的字节序列的地址。
count
检查字节数。
locale
要使用的区域设置。

返回值

根据多字节字符 c 长为 1 个或 2 个字节，_mbclen 返回 1 或 2。关于_mbclen，无错误返回。如果 mbstr 不是 NULL，mblen 返回多字节字符的字节长度。如果 mbstr 是 NULL 或它指向宽字符 null 字符，mblen 返回 0。如果 mbstr 所指向的对象不能构成在第一 count 字符内的有效字节字符，mblen 返回– 1。

备注

_mbclen 函数返回多字节字符 c的字节长度。如果 c 不指向多字节字符的前导字节，正如隐式调用 _ismbblead，_mbclen 的结果是不可预知的。

如果它是有效的多字节字符并确定多字节字符在代码页的有效性，mblen 在字节返回 mbstr的字节长度。 mblen检查count或包含在 mbstr更少字节数，但是，不会超过MB_CUR_MAX字节数。

输出值受区域设置的 LC_CTYPE 类设置影响；有关更多信息，请参见 setlocale。这些不带 _l 后缀的函数的版本使用为该区域设置相关的行为的当前区域设置；带有 _l 后缀的版本相同，只不过它们使用传递的区域设置参数。有关详细信息，请参阅区域设置。

一般文本例程映射

Tchar.h 例程	未定义 _UNICODE 和 _MBCS	已定义 _MBCS	已定义 _UNICODE
_tclen	映射到宏或内联函数	_mbclen	映射到宏或内联函数

要求

例程	必需的标头
_mbclen	<mbstring.h>
mblen	<stdlib.h>
_mblen_l	<stdlib.h>

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

示例

// crt_mblen.c
/* illustrates the behavior of the mblen function
 */

#include <stdlib.h>
#include <stdio.h>

int main( void )
{
    int      i;
    char    *pmbc = (char *)malloc( sizeof( char ) );
    wchar_t  wc   = L'a';

    printf( "Convert wide character to multibyte character:\n" );
    wctomb_s( &i, pmbc, sizeof(char), wc );
    printf( "  Characters converted: %u\n", i );
    printf( "  Multibyte character: %x\n\n", *pmbc );

    i = mblen( pmbc, MB_CUR_MAX );
    printf( "Length in bytes of multibyte character %x: %u\n", *pmbc, i );

    pmbc = NULL;
    i = mblen( pmbc, MB_CUR_MAX );
    printf( "Length in bytes of NULL multibyte character %x: %u\n", pmbc, i );
}

Output

Convert wide character to multibyte character:
  Characters converted: 1
  Multibyte character: 61

Length in bytes of multibyte character 61: 1
Length in bytes of NULL multibyte character 0: 0