manページ  — MULTIBYTE

現在のロケール (setlocale(3)) によりワイド文字とマルチバイト文字のどちらで解釈するかが決定されます。 ロケールカテゴリ LC_CTYPE の指定によりこの解釈を制御します。 型 wchar_t は、ワイド文字を表現するにあたり、すべてのロケールに対して最大の値を収容できるだけの十分な大きさを持ちます。

マルチバイト文字列には、与えられた表現中で規定されるモード間の切り替えをするための 'シフト' 指示子が含まれることがあります。 明示的にシフトの発生を表すバイト列を使用すると、これらのバイトは別々の文字とはみなされずに、それと隣接する文字と一緒にまとめられます。 '初期' シフト状態は区別されて、常に存在しています。 関数 mbstowcs() と wcstombs() は、マルチバイト文字列が初期シフト状態から始まって解釈されると仮定します。 関数 mblen(), mbtowc(), wctomb() は、内部で静的にシフト状態を維持管理します。 ポインタ mbchar がヌルである呼び出しでは、現在のロケールがシフト状態を必要とする場合は 0 以外が戻されます。シフト状態を必要としない場合は 0 が戻されます。 シフト状態を必要とする場合、シフト状態は初期状態にリセットされます。 LC_CTYPE か LC_ALL カテゴリを指定して setlocale() を呼び出した後では、内部シフト状態は未定義になります。

処理に便利なように、値が 0 のワイド文字 (ヌルワイド文字) は、ワイド文字列の終了として認識されます。 値が 0 の文字 (ヌルバイト) は、マルチバイト文字列の終了として認識されます。 マルチバイト文字では、ヌルバイト列は許可されていません。

関数 mblen() は、マルチバイト文字 mbchar のバイト長を算出します。 nbytes までが検査されます。

関数 mbtowc() はマルチバイト文字 mbchar をワイド文字に変換し、その結果を wcharp が指すオブジェクトに格納します。 nbytes バイトまでが検査されます。

関数 wctomb() はワイド文字 wchar をマルチバイト文字に変換し、その結果を mbchar に格納します。 mbchar が指すオブジェクトは、マルチバイト文字を収容できるだけの大きさを持たねばなりません。

関数 mbstowcs() は、マルチバイト文字列 mbstring をワイド文字列 wcstring. に変換します。 nwchars の大きさのワイド文字までしか格納されません。 終了を示すヌルワイド文字は、空きがある場合に付加されます。

関数 wcstombs() は、ワイド文字列 wcstring をマルチバイト文字列 mbstring に変換します。 nbytes バイトまでが mbstring に格納されます。 文字列の最後の断片的なマルチバイト文字は格納されません。マルチバイト文字列は、空きがあればヌルで終わります。