The ifx_gl_towlower() function

The ifx_gl_towlower() function converts an uppercase wide character to its lowercase equivalent.

Syntax

#include <ifxgls.h>
...
unsigned short ifx_gl_towlower(src_wc)
       gl_mchar_t *src_wc;
src_wc
A pointer to the source wide character that you want to convert to its lowercase equivalent.
Valid in client application Valid in DataBlade® UDR
Yes Yes

Usage

The ifx_gl_towlower() function returns the lowercase equivalent of the src_wc source wide character. If the locale does not define a lowercase equivalent for src_wc, ifx_gl_towlower() returns src_wc unchanged.

Return values

>0
An unsigned short integer that represents the lowercase equivalent of src_wc.
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 *src_wc value is not a valid wide character.