tgetent(3X)                                                     tgetent(3X)

NAME
     tgetent, tgetflag, tgetnum, tgetstr, tgoto - termcap-Datenbankemula-
     tion

SYNTAX
     cc [flag ...] file ... -lcurses [library ...]

     #include <term.h>

     int tgetent(char *bp, const char *name);

     int tgetflag(char id[2]);

     int tgetnum(char id[2]);

     char *tgetstr(char id[2], char **area);

     char *tgoto(char *cap, int col, int row);

BESCHREIBUNG
     Die Funktion tgetent() sucht den termcap-Eintrag für name. Die Emula-
     tion ignoriert den Zeiger bp auf den Puffer.

     Die Funktion tgetflag() ruft den booleschen Eintrag für die ID id ab.

     Die Funktion tgetnum() ruft den numerischen Eintrag für die ID id ab.

     Die Funktion tgetstr() ruft den String-Eintrag für die ID id ab. Wenn
     area kein Null-Zeiger ist und auch nicht auf einen Null-Zeiger zeigt,
     kopiert tgetstr() den String-Eintrag in den Puffer, auf den *area
     zeigt und stellt die Variable, auf die area zeigt, auf das erste Byte
     hinter der Kopie des String-Eintrags.

     Die Funktion tgoto() initialisiert die Parameter col und row in der
     Eigenschaft cap und gibt einen Zeiger auf den erzeugten String aus.

     Alle Informationen, die über die Datenbasis terminfo(4) verfügbar
     sind, brauchen nicht über diese Funktionen zur Verfügung gestellt wer-
     den.

RÜCKGABEWERT
     Funktionen, die eine Ganzzahl zurückgeben, geben nach erfolgreicher
     Ausführung den Wert OK zurück. Andernfalls geben sie ERR zurück.

     Funktionen, die Zeiger zurückgeben, geben bei einem Fehler einen
     Null-Zeiger zurück.

FEHLER
     Es sind keine Fehlerzuordnungen definiert.






Seite 1                      Reliant UNIX 5.44               Gedruckt 11/98

tgetent(3X)                                                     tgetent(3X)

HINWEISE
     Diese Funktionen sollen als Umsetzungshilfe für Programme dienen, die
     die Bibliothek termcap verwenden. Die Argumente dieser Funktionen sind
     identisch und die Funktionen werden unter Verwendung der Datenbasis
     terminfo emuliert.

     Eine einwandfreie Ausführung dieser Funktionen ist nur bei Zeichensät-
     zen garantiert, bei denen jedes Zeichen, dessen Attribute durch die
     alleinige Verwendung von Konstanten mit dem Präfix A ausgedrückt wer-
     den können, in ein Einzelbyte paßt.

     Jede Terminaleigenschaft aus der Datenbasis terminfo, die nicht über
     diese Schnittstellen abgerufen werden kann, kann über die in der Hand-
     buchseite (Man Page) tigetflag(3X) beschriebenen Schnittstellen abge-
     rufen werden.

     Portierbare Anwendungen müssen die Funktion tputs() zur Ausgabe der
     von tgetstr() und tgoto() zurückgegebenen Strings verwenden.

SIEHE AUCH
     putc(3S), curses(3X), setupterm(3X), tigetflag(3X), terminfo(4),
     term(5).
































Seite 2                      Reliant UNIX 5.44               Gedruckt 11/98