| 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の値を超えることはない。
|
