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

Article
04/22/2008

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.

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 with the _l suffix are identical except that they use the locale passed in instead of the current locale for their locale-dependent behavior. 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.
_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>
_ismbcspace	<mbstring.h>
_ismbcspace_l	<mbstring.h>

For more compatibility information, see Compatibility in the Introduction.

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.

Partager via