ismbcalnum-functions.md

description	title	ms.date	api_name	api_location	api_type	topic_type	f1_keywords	helpviewer_keywords	ms.assetid
Learn more about: _ismbcalnum, _ismbcalnum_l, _ismbcalpha, _ismbcalpha_l, _ismbcdigit, _ismbcdigit_l	_ismbcalnum, _ismbcalnum_l, _ismbcalpha, _ismbcalpha_l, _ismbcdigit, _ismbcdigit_l	4/2/2020	_ismbcalpha _ismbcalnum _ismbcdigit _ismbcalnum_l _ismbcdigit_l _ismbcalpha_l _o__ismbcalnum _o__ismbcalnum_l _o__ismbcalpha _o__ismbcalpha_l _o__ismbcdigit _o__ismbcdigit_l	msvcrt.dll msvcr80.dll msvcr90.dll msvcr100.dll msvcr100_clr0400.dll msvcr110.dll msvcr110_clr0400.dll msvcr120.dll msvcr120_clr0400.dll ucrtbase.dll api-ms-win-crt-multibyte-l1-1-0.dll	DLLExport	apiref	_ismbcdigit ismbcalnum_l _ismbcdigit_l _ismbcalpha ismbcalnum ismbcdigit ismbcalpha _ismbcalnum_l _ismbcalnum ismbcdigit_l	ismbcalpha function _ismbcalnum function ismbcdigit_l function _ismbcalnum_l function _ismbcdigit function ismbcalnum function _ismbcalpha_l function ismbcdigit function _ismbcalpha function _ismbcdigit_l function ismbcalnum_l function ismbcalpha_l function	12d57925-aebe-46e0-80b0-82b84c4c31ec

_ismbcalnum, _ismbcalnum_l, _ismbcalpha, _ismbcalpha_l, _ismbcdigit, _ismbcdigit_l

Checks whether a multibyte character is an alphanumeric, alpha, or digit character.

Important

This API cannot be used in applications that execute in the Windows Runtime. For more information, see CRT functions not supported in Universal Windows Platform apps.

Syntax

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
);

Parameters

c
Character to be tested.

locale
Locale to use.

Return value

Each of these routines returns a nonzero value if the character satisfies the test condition. Otherwise, they return 0. If c<= 255 and there's a corresponding _ismbb routine (for example, _ismbcalnum corresponds to _ismbbalnum), the result is the return value of the corresponding _ismbb routine.

Remarks

Each of these routines tests a given multibyte character for a given condition.

The versions of these functions with the _l suffix are identical except that they use the locale passed in instead of the current locale for their locale-dependent behavior. For more information, see Locale.

Routine	Test condition	Code page 932 example
_ismbcalnum, _ismbcalnum_l	Alphanumeric	Returns nonzero if and only if c is a single-byte representation of an ASCII English letter: See examples for _ismbcdigit and _ismbcalpha.
_ismbcalpha, _ismbcalpha_l	Alphabetic	Returns nonzero if and only if c is a single-byte representation of an ASCII English letter: 0x41<=c<=0x5A or 0x61<=c<=0x7A; or a katakana letter: 0xA6<=c<=0xDF.
_ismbcdigit, _ismbcdigit_l	Digit	Returns nonzero if and only if c is a single-byte representation of an ASCII digit: 0x30<=c<=0x39.

By default, this function's global state is scoped to the application. To change this behavior, see Global state in the CRT.

Requirements

Routine	Required header
_ismbcalnum, _ismbcalnum_l	<mbstring.h>
_ismbcalpha, _ismbcalpha_l	<mbstring.h>
_ismbcdigit, _ismbcdigit_l	<mbstring.h>

For more compatibility information, see Compatibility.

See also

Character classification
_ismbc routines
is, isw routines
_ismbb routines