mbstowcs() - C語言庫函數
C庫函數 size_t mbstowcs(schar_t *pwcs, const char *str, size_t n) 多字節字符字符串所指向參數str ，由pwcs指向的數組轉換。
聲明
以下是 mbstowcs() 函數的聲明。
size_t mbstowcs(schar_t *pwcs, const char *str, size_t n)
參數
pwcs -- 這就是指針到一個數組中的wchar_t的元素足夠長存儲寬字符串的最大字符長。
str -- 這是C多字節字符串來解釋。
n -- 這是wchar_t 字符的最大數目將被解釋。
返回值
這個函數返回翻譯的字符數，不包括結束空字符。如果遇到無效的多字節字符，返回-1值。
例子
下面的例子演示瞭如何使用mbstowcs() 函數。
#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); printf("Converting back to Wide-Character string
"); len = mbstowcs( pwcs, pmb, MB_CUR_MAX); printf("Characters converted %d
", len); printf("Hex value of first wide character %#.4x
", pwcs); return(0); }
讓我們編譯和運行上面的程序，這將產生以下結果：
Converting to multibyte string
Characters converted 1
Hex value of first multibyte character: 0x19a60010
Converting back to Wide-Character string
Characters converted 1
Hex value of first wide character 0x19a60030