mbsinit サブルーチン

目的

変換オブジェクトの状況を判別します。

ライブラリー

標準ライブラリー (libc.a)

構文

#include <wchar.h>

int mbsinit (const mbstate_t * ps) ;

説明

ps が NULL ポインターでない場合、 mbsinit 関数は、ps が指すオブジェクトが初期変換状態を記述するかどうかを判別します。

mbstate_t オブジェクトは、現行ロケールの LC_CTYPE カテゴリーの特定の設定の規則の下で、特定の文字シーケンスからワイド文字シーケンス (またはその逆) への現行の変換状態を記述するために使用されます。

初期変換状態は、いずれかの方向への変換の場合、初期シフト状態の新しい文字シーケンスの先頭に対応します。 ゼロ値の mbstate_t オブジェクトは、初期変換状態を記述する少なくとも 1 つの方法です。 値がゼロの mbstate_t オブジェクトを使用すると、任意の LC_CTYPE カテゴリー設定で、任意の文字シーケンスを含む変換を開始できます。

戻り値

mbsinit 関数は、 ps が NULL ポインターの場合、またはポイント先オブジェクトが初期変換状態を記述している場合は、ゼロ以外を戻します。それ以外の場合は、ゼロを戻します。

mbstate_t オブジェクトが、次のいずれかの関数によって変更されるとします。restartableその後、別の文字シーケンス、別の変換方向、または以前の関数呼び出しとは異なる LC_CTYPE カテゴリー設定で使用されると、動作は未定義になります。