The ifx_gl_ismdigit() function

Syntax

#include <ifxgls.h>
...
int ifx_gl_ismdigit(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_ismdigit() function reads as many bytes as necessary from mb to form a complete character.

Usage

The ifx_gl_ismdigit() function tests whether mb is in the digit character class according to the rules of the current locale. The digit character class contains only the 10 ASCII digit characters (ASCII 0x030 to 0x039). Any multibyte versions or alternative representations of these digits that the locale might define (for example, Hindi or Kanji digits) are not in this class. Instead, they are in the alpha class.

Characters in this class are also in the xdigit, graph, and print classes. No characters in the upper, lower, alpha, blank, space, punct, or cntrl classes are in the digit class.

To determine whether a multibyte character contains a hexadecimal digit, you can use the ifx_gl_ismxdigit() function. Use the ifx_gl_ismalnum() function to test whether a multibyte character is an alphabetic character or a digit.

Locale information

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

Return values

>0

The *mb character is in the digit character class.

0

The function was not successful, and the error number is set to indicate the cause. See the Errors section.

Errors