dbfree_xlate

Description

Free a pair of character set translation tables.

Syntax

RETCODE *dbfree_xlate(dbproc, xlt_tosrv, xlt_todisp)
 
DBPROCESS    *dbproc;
DBXLATE          *xlt_tosrv;
DBXLATE           *xlt_todisp;

Parameters

dbproc: A pointer to the DBPROCESS structure that provides the connection for a particular front-end/server process. It contains all the information that DB-Library uses to manage communications and data between the front end and server.

xlt_tosrv: A pointer to a translation table used to translate display-specific character strings to the server character strings. The translation table is allocated using dbload_xlate.

xlt_todisp: A pointer to a translation table used to translate server character strings to display-specific character strings. The translation table is allocated using dbload_xlate.

Returns

SUCCEED or FAIL.

Usage

This routine frees a pair of character set translation tables allocated by dbload_xlate.
Character set translation tables translate characters between the server’s standard character set and the display device’s character set.

The following code fragment illustrates the use of dbfree_xlate

char      destbuf[128];

int       srcbytes_used;

DBXLATE   *xlt_todisp;  DBXLATE     *xlt_tosrv;

dbload_xlate((DBPROCESS *)NULL, "iso_1",

"trans.xlt", &xlt_tosrv, &xlt_todisp);

printf("Original string: \n\t%s\n\n",

      TEST_STRING);

dbxlate((DBPROCESS *)NULL, TEST_STRING,

      strlen(TEST_STRING), destbuf, -1, xlt_todisp,

      &srcbytes_used);

printf("Translated to display character set: \

      \n\t%s\n\n", destbuf);

dbfree_xlate((DBPROCESS *)NULL, xlt_tosrv,

    xlt_todisp);

See also

dbload_xlate, dbxlate