_mbclen, mblen, _mblen_l

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

重要

此 API 不能在运行时的窗口执行的应用程序。有关更多信息,请参见 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
    使用的区域设置。

返回值

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

备注

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

mblen 在字节返回长度 mbstr,如果它是有效的多字节字符并确定多字节字符有效性与代码页。 mblen 比 MB_CUR_MAX 字节检查在 mbstr或更低字节包含的 count,但是,不是更多。

输出值受设置 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

.NET Framework 等效项

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

请参见

参考

字符类

区域设置

多字节字符序列的说明

_mbccpy, _mbccpy_l

strlen, strlen_l, wcslen, wcslen_l, _mbslen, _mbslen_l, _mbstrlen, _mbstrlen_l