BohYoh.comトップページへ  wctomb
C言語 標準ライブラリ アルファベット順索引 ヘッダ別索引 ホームページへ C言語講座のページ

C89  C99  C11  多バイト文字・ワイド文字変換関数
wctomb
ヘッダ #include <stdlib.h>
形 式 int wctomb(char *s, wchar_t wc);
機 能 wcで指定されるワイド文字に対応する多バイト文字を表現するために必要なバイト数を(シフトシーケンスも含めて)決定する。本関数は、sが空ポインタでなければ、sが指す配列に多バイト文字の表現を格納する。格納される文字数がMB_CUR_MAXを超えることはない。wcがナルワイド文字である場合、初期シフト状態に戻るために必要なシフトシーケンスがあれば、それを格納し、さらにナル文字を格納する。この場合、本関数の状態は初期変換状態になる。
 いかなるライブラリ関数も、本関数を呼び出さないかのように動作する。
返却値
sが空ポインタである場合
多バイト文字の表現形式がシフト状態に依存していれば0以外の値を返し、そうでなければ0を返す。
sが空ポインタでない場合
wcの値が正しい多バイト文字に対応する場合
wcの値に対応する多バイト文字を構成するバイト数を返す。
wcの値が正しい多バイト文字に対応しない場合
1を返す。
 返却値がマクロMB_CUR_MAXの値を超えることはない。


BohYoh.comトップページへ