Share via


_ismbcgraph, _ismbcgraph_l, _ismbcprint, _ismbcprint_l, _ismbcpunct, _ismbcpunct_l, _ismbcblank, _ismbcblank_l, _ismbcspace, _ismbcspace_l

Determines whether character is a graphical character, a display character, a punctuation character, or a space character.

Important

This API cannot be used in applications that execute in the Windows Runtime. For more information, seeCRT functions not supported with /ZW.

int _ismbcgraph(
   unsigned int c 
);
int _ismbcgraph_l(
   unsigned int c,
   _locale_t locale 
);
int _ismbcprint(
   unsigned int c 
);
int _ismbcprint_l(
   unsigned int c,
   _locale_t locale
);
int _ismbcpunct(
   unsigned int c
);
int _ismbcpunct_l(
   unsigned int c,
   _locale_t locale
);
int _ismbcblank(
   unsigned int c 
);
int _ismbcblank_l(
   unsigned int c,
   _locale_t locale
);
int _ismbcspace(
   unsigned int c 
);
int _ismbcspace_l(
   unsigned int c,
   _locale_t locale
);

Parameters

  • c
    Character to be determined.

  • locale
    Locale to use.

Return Value

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

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

Remarks

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

Routine

Test condition

Code page 932 example

_ismbcgraph

Graphic

Returns nonzero if and only if c is a single-byte representation of any ASCII or katakana printable character except a white space ( ).

_ismbcprint

Printable

Returns nonzero if and only if c is a single-byte representation of any ASCII or katakana printable character including a white space ( ).

_ismbcpunct

Punctuation

Returns nonzero if and only if c is a single-byte representation of any ASCII or katakana punctuation character.

_ismbcblank

Space or horizontal tab

Returns nonzero if and only if c is a space or horizontal tab character: c=0x20 or c=0x09.

_ismbcspace

White space

Returns nonzero if and only if c is a white-space character: c=0x20 or 0x09<=c<=0x0D.

Requirements

Routine

Required header

_ismbcgraph

<mbstring.h>

_ismbcgraph_l

<mbstring.h>

_ismbcprint

<mbstring.h>

_ismbcprint_l

<mbstring.h>

_ismbcpunct

<mbstring.h>

_ismbcpunct_l

<mbstring.h>

_ismbcblank

<mbstring.h>

_ismbcblank_l

<mbstring.h>

_ismbcspace

<mbstring.h>

_ismbcspace_l

<mbstring.h>

For more compatibility information, see Compatibility.

Libraries

All versions of the C run-time libraries.

.NET Framework Equivalent

See Also

Reference

Character Classification

Locale

Interpretation of Multibyte-Character Sequences

_ismbc Routines

is, isw Routines

_ismbb Routines