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.