The ifx_gl_iswupper() function

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

Syntax

#include <ifxgls.h>
...
int ifx_gl_iswupper(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_iswupper() function tests whether wc is in the upper character class according to the rules of the current locale. The upper character class contains:
  • the ASCII characters A through Z.
  • all other single-byte and multibyte uppercase characters for Latin-based languages; for example: Â, Ç, É, and Ü.

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

To determine the lowercase equivalent of an alphabetic wide character, you can use the ifx_gl_tomlower() function. Use the ifx_gl_ismalpha() function to test whether a wide character is an alphabetic character (uppercase or lowercase).

Locale information

The LC_CTYPE category of the current locale affects the behavior of this function because it defines the upper 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.

Copyright© 2019 HCL Technologies Limited