_ismbcgraph, _ismbcgraph_l, _ismbcprint, _ismbcprint_l, _ismbcpunct, _ismbcpunct_l, _ismbcspace, _ismbcspace_l
Determines whether character is a graphical character, a display character, a punctuation character, or a space character.
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 _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 with the _l suffix are identical except that they use the locale passed in instead of the current locale for their locale-dependent behavior.
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. |
| _ismbcspace | White space | Returns nonzero if and only if c is a white-space character: c=0x20 or 0x09<=c<=0x0D. |
| Routine | Required header | Compatibility |
|---|---|---|
| _ismbcgraph | <mbstring.h> | Windows 95, Windows 98, Windows 98 Second Edition, Windows Millennium Edition, Windows NT 4.0, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 |
| _ismbcgraph_l | <mbstring.h> | Windows 95, Windows 98, Windows 98 Second Edition, Windows Millennium Edition, Windows NT 4.0, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 |
| _ismbcprint | <mbstring.h> | Windows 95, Windows 98, Windows 98 Second Edition, Windows Millennium Edition, Windows NT 4.0, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 |
| _ismbcprint_l | <mbstring.h> | Windows 95, Windows 98, Windows 98 Second Edition, Windows Millennium Edition, Windows NT 4.0, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 |
| _ismbcpunct | <mbstring.h> | Windows 95, Windows 98, Windows 98 Second Edition, Windows Millennium Edition, Windows NT 4.0, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 |
| _ismbcpunct_l | <mbstring.h> | Windows 95, Windows 98, Windows 98 Second Edition, Windows Millennium Edition, Windows NT 4.0, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 |
| _ismbcspace | <mbstring.h> | Windows 95, Windows 98, Windows 98 Second Edition, Windows Millennium Edition, Windows NT 4.0, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 |
| _ismbcspace_l | <mbstring.h> | Windows 95, Windows 98, Windows 98 Second Edition, Windows Millennium Edition, Windows NT 4.0, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 |
For more compatibility information, see Compatibility in the Introduction.
Libraries
All versions of the C run-time libraries.
-
For _ismbcgraph and _ismbcprint: Not applicable. To call the standard C function, use PInvoke. For more information, see Platform Invoke Examples.
