The ifx_gl_lc_errno() function

The ifx_gl_lc_errno() function returns the value of the error number that some other HCL® Informix® GLS function has set.

Syntax

#include <gls.h>
...
int ifx_gl_lc_errno(void);
Valid in client application Valid in DataBlade® UDR
Yes Yes

Usage

The Informix® GLS functions set the error number, of type int, to indicate additional information about an error that occurred. Informix® GLS functions set this value only when an error occurs (unless documented otherwise). Because any Informix® GLS function can set the error number, you must use ifx_gl_lc_errno() to inspect the error number immediately after you call the function in which the error occurred.

Tip: The Errors section for each function documents the values that ifx_gl_lc_errno() returns after that particular function.

Certain code-set conversion functions are not dependent on a locale and do not set an error number that you can retrieve with ifx_gl_lc_errno(). Instead, these functions return a negative error code.

Return values

Integer error number
The error number that the Informix® GLS function has set. These error numbers are defined in the gls.h file and are described in the Errors section for each function.
-1
The function was not successful. The current processing locale has not been correctly initialized.

Errors

None