C 庫函數 – wctomb()

C 庫函數 - wctomb()

C 標準庫 - <stdlib.h>

描述

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

聲明

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

int wctomb(char *str, wchar_t wchar)

參數

• str -- 一個指針，指向一個足以存儲多字節(jié)字符的數組。
• wchar -- 類型為 wchar_t 的寬字符。

返回值

• 如果 str 不為 NULL，wctomb() 函數返回寫入字節(jié)數組中的字節(jié)數。如果 wchar 不能被表示為一個多字節(jié)序列，則會返回 -1。
• 如果 str 為 NULL，如果編碼具有移位狀態(tài)，則 wctomb() 函數返回非零，如果編碼是無狀態(tài)的，則返回零。

實例

下面的實例演示了 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("多字節(jié)字符：%.1s\n", pmb);

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

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

要轉換的寬字符：
被轉換的字符：1
多字節(jié)字符：a
當要轉換的字符為 NULL 時嘗試轉換：
被轉換的字符：0
多字節(jié)字符：

C 標準庫 - <stdlib.h>