mbsinit() — 初期状態のテスト状態オブジェクト

オンライン編集

形式

#include <wchar.h>
int mbsinit (const mbstate_t *ps);

言語レベル

ANSI

スレッド・セーフ

はい

ロケール依存

この関数の振る舞いは、現行ロケールの LC_CTYPE カテゴリーの影響を受ける可能性があります。 この関数は、コンパイル・コマンドに対して LOCALETYPE(*CLD) が指定されている場合には使用できません。 詳しくは、 CCSID とロケールについてを参照してください。

説明

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

戻り値

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

例

この例では、変換状態が初期状態であるかどうかを表示して確認します。
#include <stdio.h>
#include <wchar.h>
#include <stdlib.h>
 
main()
{
   char     *string = "ABC";
   mbstate_t state = 0;
   wchar_t   wc;
   int   rc;
 
   rc = mbrtowc(&wc, string, MB_CUR_MAX, &state);
   if (mbsinit(&state))
     printf("In initial conversion state\n");
}

関連情報