_ismbcgraph, _ismbcgraph_l, _ismbcprint, _ismbcprint_l, _ismbcpunct, _ismbcpunct_l, _ismbcblank, _ismbcblank_l, _ismbcspace, _ismbcspace_l
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 _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.
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.
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.
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. |
| 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.
All versions of the C run-time libraries.
For
_ismbcgraphand_ismbcprint: Not applicable. To call the standard C function, usePInvoke. For more information, see Platform Invoke Examples.
Character Classification
Locale
Interpretation of Multibyte-Character Sequences
_ismbc Routines
is, isw Routines
_ismbb Routines