C 庫函數 - wctomb()

C 標準庫 - <stdlib.h> C 標準庫 - <stdlib.h>

描述

C 庫函數 int wctomb(char *str, wchar_t wchar) 把寬字元 wchar 轉換為它的多位元組表示形式，並把它存儲在 str 指向的字元數組的開頭。

聲明

下麵是 wctomb() 函數的聲明。

int wctomb(char *str, wchar_t wchar)

參數

  • str -- 一個指針，指向一個足以存儲多位元組字元的數組。
  • wchar -- 類型為 wchar_t 的寬字元。

返回值

  • 如果 str 不為 NULL，wctomb() 函數返回寫入位元組數組中的位元組數。如果 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("要轉換的寬字元：\n");
   i = wctomb( pmb, wc );
   printf("被轉換的字元：%u\n", i);
   printf("多位元組字元：%.1s\n", pmb);

   printf("當要轉換的字元為 NULL 時嘗試轉換：\n");
   i = wctomb( pmbnull, wc );
   printf("被轉換的字元：%u\n", i);
   /* 不會輸出任何值 */
   printf("多位元組字元：%.1s\n", pmbnull);

   return(0);
}

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

要轉換的寬字元：
被轉換的字元：1
多位元組字元：a
當要轉換的字元為 NULL 時嘗試轉換：
被轉換的字元：0
多位元組字元：

C 標準庫 - <stdlib.h> C 標準庫 - <stdlib.h>