_setmbcp

  • [アーティクル]

新しいマルチバイト コード ページを設定します。

構文

int _setmbcp(
   int codepage
);

パラメーター

codepage
ロケールに依存しないマルチバイトのルーチンのための新しいコード ページ設定。

戻り値

コード ページが正常に設定されている場合は、0 を返します。 無効なコード ページ値が指定された codepage場合、-1 が返され、コード ページの設定は変更されません。 メモリ割り当ての失敗が発生した場合には、errno を EINVAL に設定します。

解説

_setmbcp 関数は新しいマルチバイト コード ページを指定します。 既定では、ランタイム システムはマルチバイト コード ページを、システムの既定の ANSI コード ページに自動的に設定します。 マルチバイト コード ページの設定は、ロケールに依存しないすべてのマルチバイト ルーチンに影響します。 ただし、現在のロケールに対して定義されているコード ページを使用するように指示 _setmbcp することもできます (マニフェスト定数と関連する動作結果の次の一覧を参照してください)。 マルチバイト コード ページではなくロケール コード ページに依存するマルチバイト ルーチンの一覧については、「マルチバイト文字シーケンスの解釈」を参照してください。

codepage 引数は、次の値のいずれかに設定できます。

  • _MB_CP_ANSI プログラムの起動時にオペレーティング システムから取得した ANSI コード ページを使用します。

  • _MB_CP_LOCALE 前の呼び出しから取得した現在のロケールのコード ページを使用します setlocale。

  • _MB_CP_OEM プログラムの起動時にオペレーティング システムから取得した OEM コード ページを使用します。

  • _MB_CP_SBCS 1 バイト コード ページを使用します。 コード ページが設定されている場合、常に _MB_CP_SBCSfalse などの _ismbblead ルーチンが返されます。

  • _MB_CP_UTF8 UTF-8 を使用します。 コード ページが設定されている場合、常に _MB_CP_UTF8false などの _ismbblead ルーチンが返されます。

  • 値が ANSI、OEM、またはその他のオペレーティング システムでサポートされているコード ページ (サポートされていない UTF-7 を除く) のいずれであるかに関係なく、その他の有効なコード ページ値。

既定では、この関数のグローバル状態の適用対象は、アプリケーションになります。 この動作を変更するには、「CRT のグローバル状態」を参照してください。

必要条件

ルーチンによって返される値 必須ヘッダー
_setmbcp <mbctype.h>

互換性の詳細については、「 Compatibility」を参照してください。

関連項目

_getmbcp
setlocale, _wsetlocale