Function summary

This topic groups all the functions of the HCL® Informix® GLS library by task.

Memory allocation

The Informix® GLS library provides the following macro and function to assist in memory allocation:
  • The IFX_GL_MB_MAX macro
  • The ifx_gl_mb_loc_max() function

For more information, see Allocate memory.

Initialization and error handling

The Informix® GLS library provides the following functions:

Stream input and output

The Informix® GLS library provides the ifx_gl_getmb() and ifx_gl_putmb() functions to input and output multibyte characters in a user-defined location.

For more information, see Input and output streams.

Character processing

Most of the Informix® GLS functions provide support for character processing of both multibyte and wide characters. This section lists the character-processing tasks and the Informix® GLS functions that support them. For general information about character processing, see Character processing.

Code-set conversion

The Informix® GLS library provides the following functions to perform code-set conversion:
  • ifx_gl_conv_needed()
  • ifx_gl_cv_mconv()
  • ifx_gl_cv_outbuflen()
  • ifx_gl_cv_sb2sb_table()
For general information, see Code-set conversion.

Character classification

The Informix® GLS library provides the following functions for character classification of multibyte and wide characters.
Multibyte-character classification Wide-character classification
ifx_gl_ismalnum() ifx_gl_iswalnum()
ifx_gl_ismalpha() ifx_gl_iswalpha()
ifx_gl_ismblank() ifx_gl_iswblank()
ifx_gl_ismcntrl() ifx_gl_iswcntrl()
ifx_gl_ismdigit() ifx_gl_iswdigit()
ifx_gl_ismgraph() ifx_gl_iswgraph()
ifx_gl_ismlower() ifx_gl_iswlower()
ifx_gl_ismprint() ifx_gl_iswprint()
ifx_gl_ismpunct() ifx_gl_iswpunct()
ifx_gl_ismspace() ifx_gl_iswspace()
ifx_gl_ismupper() ifx_gl_iswupper()
ifx_gl_ismxdigit() ifx_gl_iswxdigit()
For general information, see ids_gpg_037.html.

Case conversion

The Informix® GLS library provides the following functions for case conversion of multibyte and wide characters.
Multibyte-character case conversion Wide-character case conversion
ifx_gl_tomlower() ifx_gl_towlower()
ifx_gl_tomupper() ifx_gl_toupper()
ifx_gl_mbsspn() ifx_gl_wcsspn()
In addition, the Informix® GLS library provides the function ifx_gl_case_conv_outbuflen(). For general information, see Case conversion.

String traversal

The Informix® GLS library provides the following functions for string traversal of multibyte-character strings:
  • ifx_gl_mblen()
  • ifx_gl_mbsnext()
  • ifx_gl_mbsprev()
For general information, see String traversal.

String processing

The Informix® GLS library provides the following functions for string processing of multibyte and wide characters.
Multibyte-character classification Wide-character classification
ifx_gl_mbscat() ifx_gl_wcscat()
ifx_gl_mbschr() ifx_gl_wcschr()
ifx_gl_mbscpy() ifx_gl_wcscpy()
ifx_gl_mbscspn() ifx_gl_wcscspn()
ifx_gl_mbslen() ifx_gl_wcslen()
ifx_gl_mbsmbs() ifx_gl_wcswcs()
ifx_gl_mbsncat() ifx_gl_wcsncat()
ifx_gl_mbsncpy() ifx_gl_wcsncpy()
ifx_gl_mbsntslen() ifx_gl_wcsntslen()
ifx_gl_mbsntsbytes() None
ifx_gl_mbspbrk() ifx_gl_wcspbrk()
ifx_gl_mbsrchr() ifx_gl_wcsrchr()
ifx_gl_mbsspn() ifx_gl_wcsspn()
For general information, see String processing.

Character/string comparison and sorting

The Informix® GLS library provides the ifx_gl_mbscoll() and ifx_gl_wcscoll() functions to obtain locale-specific order for characters and strings.

For general information, see Character/string comparison and sorting.

Data formatting

The Informix® GLS library provides functions to support the conversion and formatting of locale-specific strings. This section lists the data types that involve locale-specific strings and the Informix® GLS functions that support them. For general information about data formatting, see Data formatting.

Date and time conversion and formatting functions

The Informix® GLS library provides the following functions for conversion and formatting of date and date/time strings:
  • ifx_gl_convert_date()
  • ifx_gl_convert_datetime()
  • ifx_gl_format_date()
  • ifx_gl_format_datetime()

Numeric conversion and formatting

The Informix® GLS library provides the ifx_gl_convert_number() and ifx_gl_format number() functions for conversion and formatting of number strings.

Money conversion and formatting

The Informix® GLS library provides the ifx_gl_convert_money() and ifx_gl_format_money() functions for conversion and formatting of money strings.