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

2017-06-05

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.

Important

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

Syntax

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

System::Char::IsPunctuation
System::Char::IsWhiteSpace
For _ismbcgraph and _ismbcprint: Not applicable. To call the standard C function, use PInvoke. For more information, see Platform Invoke Examples.

Share via