wctomb() - C語言庫函式

C庫函式 int wctomb(char *str, wchar_t wchar) 函式將寬字元wchar 多位元組表示，並把它儲存在字元陣列指向 bystr 的開始。

宣告

以下是wctomb() 函式的宣告。

int wctomb(char *str, wchar_t wchar)

引數

str -- 這是大到足以容納一個多位元組字元陣列的指標，
wchar -- 這是寬字元wchar_t型別。

返回值

如果str是不是NULL，wctomb() 函式返回已寫入位元組陣列 str 位元組數。如果wchar 不能表示為多位元組序列，則返回-1。
如果str是NULL，wctomb() 函式返回非零如果編碼非平凡的轉變狀態，或者為零，如果編碼是無狀態的。

例子

下面的例子顯示 wctomb() 函式的用法。

#include <stdio.h>
#include <stdlib.h>

int main()
{
   int i;
   wchar_t wc = L'a';
   char *pmbnull = NULL;
   char *pmb = (char *)malloc(sizeof( char ));

   printf("Converting wide character:
");
   i = wctomb( pmb, wc );
   printf("Characters converted: %u
", i);
   printf("Multibyte character: %.1s
", pmb);

   printf("Trying to convert when target is NULL:
");
   i = wctomb( pmbnull, wc );
   printf("Characters converted: %u
", i);
   /* this will not print any value */
   printf("Multibyte character: %.1s
", pmbnull);
   
   return(0);
}

讓我們編譯和執行上面的程式，這將產生以下結果：

Converting wide character:
Characters converted: 1
Multibyte character: a
Trying to convert when target is NULL:
Characters converted: 0
Multibyte character: