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: