The ifx_gl_iswalpha() function

The ifx_gl_iswalpha() function determines whether a wide character contains an alphabetic character.

Syntax

#include <ifxgls.h>
...
int ifx_gl_iswalpha(wc)
       gl_wchar_t *wc;
wc
A pointer to the wide character whose character classification you want to determine.
Valid in client application Valid in DataBlade® UDR
Yes Yes

Usage

The ifx_gl_iswalpha() function tests whether wc is in the alpha character class according to the rules of the current locale. The alpha class contains all characters from the upper and lower classes. In addition to the uppercase and lowercase Latin-based characters, this class includes any alphabetic characters that the locale might define, including:
  • Asian ideographic characters; for example, Kanji characters.
  • Asian phonetic characters; for example, single-byte and multibyte Katakana and Hiragana characters.
  • non-ASCII digit characters (see the digit class).
  • Latin-based alphabetic characters that do not have a case-equivalent character.
  • user-defined characters.
  • vendor-defined characters.

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

To determine the case of a wide alphabetic character, you can use the ifx_gl_iswupper() and ifx_gl_iswlower() functions. Use the ifx_gl_iswalnum() function to test whether a wide 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 alpha character class.

Return values

>0
The wc 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

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 the following value.
IFX_GL_EILSEQ
The *wc value is not a valid wide character.