C語言 庫函數(shù) mblen()

C語言 標準庫 <stdlib.h>

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

1. 聲明

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

int mblen(const char *str, size_t n)

2. 參數(shù)

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

3. 返回值

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

4. 實例

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

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

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

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

C語言 標準庫 <stdlib.h>