C語言 庫函數 wctomb()

C語言 標準庫 <stdlib.h>

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

1. 聲明

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

int wctomb(char *str, wchar_t wchar)

2. 參數

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

3. 返回值

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

4. 實例

下面的實例演示了 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>