PtTerminalCreateCsXlat()

Create a translation table for PtTerminal's character sets

Synopsis:

PtTerminalCsXlatData_t *PtTerminalCreateCsXlat( 
    PtTerminalCharsets_t const *csets );

Description:

This function creates a translation table for the character sets used by PtTerminal. The PtTerminalCsXlatData_t structure is for internal use only; you must use this function to create it.

The csets argument is a pointer to a PtTerminalCharsets_t structure that defines the character sets and their translation.

Returns:

A pointer to a PtTerminalCsXlatData_t structure that you can use to set the Pt_ARG_TERM_CHARSETS resource of a PtTerminal widget.

PtTerminalCreateCsXlat() doesn't make a copy of the PtTerminalCharsets_t structure pointed to by csets, and PtTerminal doesn't make a copy of the PtTerminalCsXlatData_t structure when you set Pt_ARG_TERM_CHARSETs. Don't free these structures until they're no longer needed by any widget. The PtTerminalCsXlatData_t structure created by PtTerminalCreateCsXlat() is placed in a single allocated block of memory. When it's no longer needed, you can simply free() it.

Classification:

Photon

See also:

PtTerminal, Pt_ARG_TERM_CHARSETS, PtTerminalCharsets_t