mblen() - C語言庫函式

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("Converting to multibyte string
");
   len = wcstombs( pmb, pwc, MB_CUR_MAX);
   printf("Characters converted %d
", len);
   printf("Hex value of first multibyte character: %#.4x
", pmb);
   
   len = mblen( pmb, MB_CUR_MAX );
   printf( "Length in bytes of multibyte character %x: %u
", pmb, len );
   
   pmb = NULL;
   
   len = mblen( pmb, MB_CUR_MAX );
   printf( "Length in bytes of multibyte character %x: %u
", pmb, len );
   
   return(0);
}

讓我們編譯和執行上面的程式，這將產生以下結果：

Converting to multibyte string
Characters converted 1
Hex value of first multibyte character: 0x168c6010
Length in bytes of multibyte character 168c6010: 1
Length in bytes of multibyte character 0: 0