# C 庫函數 - mblen() ## 描述 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 ```