The ifx_gl_ismgraph() function

The ifx_gl_ismgraph() function determines whether a multibyte character contains a graphical (visible) character.

Syntax

#include <ifxgls.h>
...
int ifx_gl_ismgraph(mb, mb_byte_limit)
       gl_mchar_t *mb;
       int mb_byte_limit;

mb: A pointer to the multibyte character whose character classification you want to determine.
mb_byte_limit: The integer number of bytes to read from mb to try to form a complete multibyte character. If mb_byte_limit is IFX_GL_NO_LIMIT, the ifx_gl_ismgraph() function reads as many bytes as necessary from mb to form a complete character.


Valid in client application	Valid in DataBlade® UDR
Yes	Yes

Usage

The ifx_gl_ismgraph() function tests whether mb is in the graph character class according to the rules of the current locale. The graph character class contains all characters that have a visual representation, including characters from the alpha, digit, punct, and xdigit classes. In addition, all placeholder characters used in round-trip code-set conversion are in this class.

Characters in the graph class are also in the print class. No characters in the blank, space, or cntrl classes are in the graph class.

Locale information

The LC_CTYPE category of the current locale affects the behavior of this function because it defines the graph character class.

Return values

>0: The *mb character is in the graph character class.
0: The function was not successful, and the error number is set to indicate the cause. See the Errors section.

Errors

This function does not return a unique value to indicate an error. If an error occurred, the function returns 0 and sets the ifx_gl_lc_errno() error number to one of the following values.

IFX_GL_EILSEQ: The *mb value is not a valid multibyte character.
IFX_GL_EINVAL: The function cannot determine whether mb is a valid multibyte character because it would need to read more than mb_byte_limit bytes from mb. If mb_byte_limit is less than or equal to 0, this function always returns this error.