_ismbclegal、_ismbclegal_l、_ismbcsymbol、_ismbcsymbol_l

[アーティクル]
08/09/2011

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

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 を返します。 c <= 255 であり、対応する _ismbb ルーチンがある場合 (たとえば、_ismbcalnum は _ismbbalnum に対応)、結果は対応する _ismbb ルーチンの戻り値です。

解説

これらの関数は、指定されたマルチバイト文字が所定の条件を満たしているかどうかを調べます。

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

ルーチン	テスト条件	コードページ 932 の例
_ismbclegal	有効なマルチバイト文字	c の最初のバイトが 0x81 ～ 0x9F または 0xE0 ～ 0xFC の範囲にあり、2 番目のバイトが 0x40 ～ 0x7E または 0x80 ～ 0xFC の範囲にある場合にだけ、0 以外の値を返します。
_ismbcsymbol	マルチバイトシンボル	c が 0x8141<=c<=0x81AC の範囲にある場合にだけ、0 以外の値を返します。