_ismbcalnum、_ismbcalnum_l、_ismbcalpha、_ismbcalpha_、_ismbcdigit、_ismbcdigit_l

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

マルチバイト文字が英数字、英字、または数字であるかどうかをチェックします。

int _ismbcalnum
(
   unsigned int c 
);
int _ismbcalnum_l
(
   unsigned int c,
   _locale_t locale
);
int _ismbcalpha
(
   unsigned int c 
);
int _ismbcalpha_l
(
   unsigned int c,
   _locale_t locale
);
int _ismbcdigit
(
   unsigned int c 
);
int _ismbcdigit_l
(
   unsigned int c,
   _locale_t locale
);

パラメータ

c
テストされる整数。
locale
使用するロケール。

戻り値

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

解説

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

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

ルーチン	テスト条件	コードページ 932 の例
_ismbcalnum,_ismbcalnum_l	英数字	c が 1 バイト ASCII 英数字の場合にだけ、0 以外の値を返します。_ismbcdigit および _ismbcalpha の例を参照してください。
_ismbcalpha,_ismbcalpha_l	英字	c が 1 バイト ASCII 英字 (0x41<=c<=0x5A または 0x61<=c<=0x7A) または半角カタカナ文字 (0xA6<=c<=0xDF) の場合にだけ、0 以外の値を返します。
_ismbcdigit,_ismbcdigit	数字	c が 1 バイト ASCII 数字 (0x30<=c<=0x39) の場合にだけ、0 以外の値を返します。