C 库函数 - mblen()

描述

C 库函数 int mblen(const char *str, size_t n) 返回参数 str 所指向的多字节字符的长度。

声明

下面是 mblen() 函数的声明。

  1. int mblen(const char *str, size_t n)

参数

  • str — 指向多字节字符的第一个字节的指针。
  • n — 要检查的字符长度的最大字节数。

返回值

如果识别了一个非空宽字符，mblen() 函数返回 str 开始的多字节序列解析的字节数。如果识别了一个空宽字符，则返回 0。如果识别了一个无效的多字节序列，或者不能解析一个完整的多字节字符，则返回 -1。

实例

下面的实例演示了 mblen() 函数的用法。

  1. #include <stdio.h>
  2. #include <stdlib.h>
  3. #include <string.h>
  5. int main()
  6. {
  7.    int len;
  8.    char *pmbnull  = NULL;
  9.    char *pmb = (char *)malloc( MB_CUR_MAX );
  10.    wchar_t *pwc = L"Hi";
  11.    wchar_t *pwcs = (wchar_t *)malloc( sizeof( wchar_t ));
  13.    printf("转换为多字节字符串\n");
  14.    len = wcstombs( pmb, pwc, MB_CUR_MAX);
  15.    printf("被转换的字符 %d\n", len);
  16.    printf("第一个多字节字符的十六进制值：%#.4x\n", pmb);
  18.    len = mblen( pmb, MB_CUR_MAX );
  19.    printf( "多字节字符 %x 的字节长度：%u\n", pmb, len );
  21.    pmb = NULL;
  23.    len = mblen( pmb, MB_CUR_MAX );
  24.    printf( "多字节字符 %x 的字节长度：%u\n", pmb, len );
  26.    return(0);
  27. }

让我们编译并运行上面的程序，这将产生以下结果：

  1. 转换为多字节字符串
  2. 被转换的字符 1
  3. 第一个多字节字符的十六进制值：0x168c6010
  4. 多字节字符 168c6010 的字节长度：1
  5. 多字节字符 0 的字节长度：0