PxTerminalLoadCharsets()

Load character-set information from a file

Synopsis:

#include <photon/PxTerminal.h>

PtTerminalCharsets_t *PxTerminalLoadCharsets(
        const char *filename,
        PxTerminalCsNames_t *names );

Library:

phexlib

Description:

PxTerminalLoadCharsets() loads character-set information from the given file. The names argument, if not NULL, points to a structure that the names of the character sets will be stored in.

This function puts the resulting structure and all the tables and strings in a single allocated block of memory. After it's no longer needed, you can simply free() it. Note that this invalidates the strings stored in *names.

Returns:

A pointer to a PtTerminalCharsets_t structure ready for use with a PtTerminal widget.

Classification:

Photon

Safety:
Interrupt handler No
Signal handler No
Thread No

See also:

PxTerminalBuildCharsets(), PxTerminalSaveCharsets()

PtTerminal, PtTerminalCharsets_t in the Photon Widget Reference