_ismbclegal、_ismbclegal_l、_ismbcsymbol、_ismbcsymbol_l
更新 : 2007 年 11 月
マルチバイト文字が有効な文字かどうか、またはシンボル文字かどうかをチェックします。
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 以外の値を返します。 |
汎用テキスト ルーチンのマップ
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> |
互換性の詳細については、「C ランタイム ライブラリ」の「互換性」を参照してください。
.NET Framework の相当するアイテム
適用できません。標準 C 関数を呼び出すには、PInvoke を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。