C 庫函數 - mblen()

C 標準庫 - <stdlib.h> C 標準庫 - <stdlib.h>

描述

C 庫函數 int mblen(const char *str, size_t n) 返回參數 str 所指向的多字節字符的長度。

聲明

下面是 mblen() 函數的聲明。

int mblen(const char *str, size_t n)

參數

  • str -- 指向多字節字符的第一個字節的指針。
  • n -- 要檢查的字符長度的最大字節數。

返回值

如果識別了一個非空寬字符，mblen() 函數返回 str 開始的多字節序列解析的字節數。如果識別了一個空寬字符，則返回 0。如果識別了一個無效的多字節序列，或者不能解析一個完整的多字節字符，則返回 -1。

實例

下面的實例演示了 mblen() 函數的用法。

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

int main()
{
   int len;
   char *pmbnull  = NULL;
   char *pmb = (char *)malloc( MB_CUR_MAX );
   wchar_t *pwc = L"Hi";
   wchar_t *pwcs = (wchar_t *)malloc( sizeof( wchar_t ));

   printf("轉換為多字節字符串\n");
   len = wcstombs( pmb, pwc, MB_CUR_MAX);
   printf("被轉換的字符 %d\n", len);
   printf("第一個多字節字符的十六進制值：%#.4x\n", pmb);
   
   len = mblen( pmb, MB_CUR_MAX );
   printf( "多字節字符 %x 的字節長度：%u\n", pmb, len );
   
   pmb = NULL;
   
   len = mblen( pmb, MB_CUR_MAX );
   printf( "多字節字符 %x 的字節長度：%u\n", pmb, len );
   
   return(0);
}

讓我們編譯并運行上面的程序，這將產生以下結果：

轉換為多字節字符串
被轉換的字符 1
第一個多字節字符的十六進制值：0x168c6010
多字節字符 168c6010 的字節長度：1
多字節字符 0 的字節長度：0

C 標準庫 - <stdlib.h> C 標準庫 - <stdlib.h>