_ismbb Routines

 

The new home for Visual Studio documentation is Visual Studio 2017 Documentation on docs.microsoft.com.

The latest version of this topic can be found at _ismbb Routines.

Tests the given integer value c for a particular condition, by using the current locale or a specified LC_CTYPE conversion state category.

_ismbbalnum, _ismbbalnum_l_ismbbkprint, _ismbbkprint_l
_ismbbalpha, _ismbbalpha_l_ismbbkpunct, _ismbbkpunct_l
_ismbbblank, _ismbbblank_l_ismbblead, _ismbblead_l
_ismbbgraph, _ismbbgraph_l_ismbbprint, _ismbbprint_l
_ismbbkalnum, _ismbbkalnum_l_ismbbpunct, _ismbbpunct_l
_ismbbkana, _ismbbkana_l_ismbbtrail, _ismbbtrail_l

Every routine in the _ismbb family tests the given integer value c for a particular condition. The test result depends on the multibyte code page that's in effect. By default, the multibyte code page is set to the ANSI code page that's obtained from the operating system at program startup. You can use _getmbcp to query for the multibyte code page that's in use, or _setmbcp to change it.

The output value is affected by the setting of the LC_CTYPE category setting of the locale; for more information, see setlocale, _wsetlocale. The versions of these functions that don't have the _l suffix use the current locale for this locale-dependent behavior; the versions that do have the _l suffix are identical except that instead they use the locale parameter that's passed in.

The routines in the _ismbb family test the given integer c as follows.

RoutineByte test condition
_ismbbalnumisalnum || _ismbbkalnum.
_ismbbalphaisalpha || _ismbbkalnum.
_ismbbblankisblank
_ismbbgraphSame as _ismbbprint, but _ismbbgraph does not include the space character (0x20).
_ismbbkalnumNon-ASCII text symbol other than punctuation. For example, in code page 932 only, _ismbbkalnum tests for katakana alphanumeric.
_ismbbkanaKatakana (0xA1 – 0xDF). Specific to code page 932.
_ismbbkprintNon-ASCII text or non-ASCII punctuation symbol. For example, in code page 932 only, _ismbbkprint tests for katakana alphanumeric or katakana punctuation (range: 0xA1 – 0xDF).
_ismbbkpunctNon-ASCII punctuation. For example, in code page 932 only, _ismbbkpunct tests for katakana punctuation.
_ismbbleadFirst byte of multibyte character. For example, in code page 932 only, valid ranges are 0x81 – 0x9F, 0xE0 – 0xFC.
_ismbbprintisprint || _ismbbkprint. ismbbprint includes the space character (0x20).
_ismbbpunctispunct || _ismbbkpunct.
_ismbbtrailSecond byte of multibyte character. For example, in code page 932 only, valid ranges are 0x40 – 0x7E, 0x80 – 0xEC.

The following table shows the ORed values that compose the test conditions for these routines. The manifest constants _BLANK, _DIGIT, _LOWER, _PUNCT, and _UPPER are defined in Ctype.h.

Routine_BLANK_DIGITLOWER_PUNCTUPPERNon-

ASCII

text
Non-

ASCII

punct
_ismbbalnumxxxx
_ismbbalphaxxx
_ismbbblankx
_ismbbgraphxxxxxx
_ismbbkalnumx
_ismbbkprintxx
_ismbbkpunctx
_ismbbprintxxxxxxx
_ismbbpunctxx

The _ismbb routines are implemented both as functions and as macros. For more information about how to choose either implementation, see Recommendations for Choosing Between Functions and Macros.

Not applicable, but see System::Globalization::CultureInfo.

Byte Classification
is, isw Routines
_mbbtombc, _mbbtombc_l
_mbctombb, _mbctombb_l

Show: