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