_ismbclegal, _ismbclegal_l, _ismbcsymbol, _ismbcsymbol_l

  • [アーティクル]

マルチバイト文字が有効な文字または記号かどうかをチェックします。

重要

この API は、Windows ランタイムで実行するアプリケーションでは使用できません。 詳細については、「ユニバーサル Windows プラットフォーム アプリでサポートされていない CRT 関数」を参照してください。

構文

int _ismbclegal(
   unsigned int c
);
int _ismbclegal_l(
   unsigned int c,
   _locale_t locale
);
int _ismbcsymbol(
   unsigned int c
);
int _ismbcsymbol_l(
   unsigned int c,
   _locale_t locale
);

パラメーター

c
テストする文字。

locale
使用するロケール。

戻り値

文字がテスト条件を満たす場合、これらの各ルーチンは 0 以外の値を返します。 それ以外の場合は、0 を返します。 = 255 で、対応する_ismbbルーチン (たとえば、対応_ismbbalnumするルーチン) がある場合<c、_ismbcalnum結果は対応する_ismbbルーチンの戻り値になります。

解説

これらの各関数は特定の条件で特定のマルチバイト文字をテストします。

これらの関数のうち _l サフィックスが付けられたバージョンは同じですが、ロケールに依存する動作に現在のロケールではなく渡されたロケールを使用するという点で異なります。 詳細については、「 Locale」を参照してください。

ルーチンによって返される値 テスト条件 コード ページ 932 の例
_ismbclegal 有効なマルチバイト c の最初のバイトが 0x81 - 0x9F または 0xE0 - 0xFC の範囲内にあり、2 番目のバイトが 0x40 - 0x7E または 0x80 - FC の範囲内にある場合にのみ、0 以外の値を返します。
_ismbcsymbol マルチバイトの記号 0x8141<=c<=0x81AC の場合にのみ、0 以外の値を返します。

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

汎用テキスト ルーチンのマップ

Tchar.h のルーチン _UNICODE と _MBCS が定義されていない _MBCS が定義されている _UNICODE が定義されている
_istlegal 常に false を返します _ismbclegal 常に false を返します。
_istlegal_l 常に false を返します _ismbclegal_l 常に false を返します。

必要条件

ルーチンによって返される値 必須ヘッダー
_ismbclegal, _ismbclegal_l <mbstring.h>
_ismbcsymbol, _ismbcsymbol_l <mbstring.h>

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

関連項目

文字分類
_ismbc ルーチン
is、 isw ルーチン
_ismbb ルーチン