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>