Edit

Share via

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

  • Article

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, see CRT functions not supported in Universal Windows Platform apps.

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. Otherwise, they return 0. If c <= 255 and there's 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.

By default, this function's global state is scoped to the application. To change this behavior, see Global state in the CRT.

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.

See also

Character classification
Locale
Interpretation of multibyte-character sequences
_ismbc routines
is, isw routines
_ismbb routines