The ifx_gl_cv_sb2sb_table() function

The ifx_gl_cv_sb2sb_table() function returns the single-byte conversion table from the source code set to the destination code set.

Syntax

#include <ifxgls.h>
...
int ifx_gl_cv_sb2sb_table(dst_codeset, src_codeset, array)
       char *dst_codeset;
       char *src_codeset;
       unsigned char **array;
dst_codeset
A pointer to the name of the destination (target) code set.
src_codeset
A pointer to the name of the source code set.
array
A pointer to a variable that points to a table of unsigned char values representing the conversion
Valid in client application Valid in DataBlade® UDR
Yes Yes

Usage

If the code-set conversion from src_codeset to dst_codeset converts from one single-byte code set to another single-byte code set (where no substitution conversions occur), the ifx_gl_cv_sb2sb_table() function sets array to an array of 256 unsigned char values that represent the conversion. If the code-set conversion is not of this form, the function sets array to NULL.

The code sets, src_codeset and dst_codeset, can be any of the following:
  • Locale names
  • Code-set names
  • The IFX_GL_PROC_CS macro

Return values

0
The function was successful, and the array argument points to the conversion table.
-1
The function was not successful, and the error number is set to indicate the cause. See the Errors section.

Errors

If an error occurred, this function returns -1 and sets the ifx_gl_lc_errno() error number to the following value.
IFX_GL_FILEERR
Retrieval of the conversion information for the specified code sets failed. This failure might be due to invalid code-set names, a missing registry file, a missing code-set-conversion object file or one with an incorrect format, or insufficient memory for the code-set-conversion object.