mbtowc

＜mbtowc＞
概要	多バイト文字をワイド文字に変換する。
ヘッダ	`#include <stdlib.h>`
I/F	`int mbtowc(wchar_t * restrict pwc, const char * restrict s, size_t n);`
戻り値	sが空ポインタである場合、多バイト文字の表現形式がシフト状態に依存しているなら0以外の値、そうでないなら0。sが空ポインタでない場合、sがナル文字を指すなら0、次のn個以下のバイト列が正しい多バイト文字を形成するならその多バイト文字を構成するバイト数、それらが正しい多バイト文字を形成しないなら-1。
詳細	mbtowc関数は、多バイト文字sを最大nバイト検査し、多バイト文字に対応するワイド文字をpwcに格納する。対応するワイド文字がナルワイド文字である場合、この関数の状態は初期変換状態になる。mbtowc関数の動作はその時点のロケールのLC_CTYPEカテゴリの影響を受ける。