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