tigetflag(3X)                                                 tigetflag(3X)

NAME
     tigetflag, tigetnum, tigetstr, tparm - Eigenschaften aus der Datenba-
     sis terminfo abrufen

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

     #include <term.h>

     int tigetflag(char *capname);

     int tigetnum(char *capname);

     char *tigetstr(char *capname);

     char *tparm(char *cap, long p1, long p2, long p3, long p4,
           long p5, long p6, long p7, long p8, long p9);

BESCHREIBUNG
     Die Funktionen tigetflag(), tigetnum() und tigetstr() rufen boolesche,
     numerische bzw. String-Eigenschaften aus dem ausgewählten Datensatz
     der Datenbasis terminfo ab. Für jede Eigenschaft wird der Wert, der
     als capname (Eigenschaftsname) verwendet werden soll, in der Spalte
     Capname der Tabelle in terminfo(4) ausgegeben.

     Für die Funktion tparm() ist als Eigenschaft cap eine String-Eigen-
     schaft erforderlich. Wenn cap parametrisiert ist (wie in "X/Open Cur-
     ses, Issue 4, Version 2, Abschnitt A.1.2" beschrieben), löst tparm()
     die Parametrisierung auf. Wenn sich der parametrisierte String auf
     Parameter von %p1 bis %p9 bezieht, ersetzt tparm() die entsprechenden
     Werte von p1 bis p9.

RÜCKGABEWERT
     Nach erfolgreicher Ausführung geben die Funktionen tigetflg(),
     tigetnum() und tigetstr() die angegebene Eigenschaft zurück. Die Funk-
     tion tigetflag() gibt -2 zurück, wenn capname keine boolesche Eigen-
     schaft ist. Die Funktion tigetnum() gibt -2 zurück, wenn capname keine
     numerische Eigenschaft ist. Die Funktion tigetstr() gibt (char *)-1
     zurück, wenn capname keine String-Eigenschaft ist.

     Nach erfolgreicher Ausführung gibt tparm() den String str zurück, in
     dem die Parametrisierung aufgelöst ist. Andernfalls wird ein Null-Zei-
     ger zurückgegeben.

FEHLER
     Es sind keine Fehlerzuordnungen definiert.

HINWEISE
     Bei parametrisierten String-Eigenschaften sollte die Anwendung den
     Rückgabewert von tigetstr() an tparm() wie oben beschrieben weiterge-
     ben.




Seite 1                      Reliant UNIX 5.44               Gedruckt 11/98

tigetflag(3X)                                                 tigetflag(3X)

     Anwendungen, die Terminaleigenschaften direkt (und nicht über Curses)
     an das Terminal senden wollen (wozu nur die Funktionen tputs() oder
     putp() verwendet werden sollten), müssen die folgenden Regeln beach-
     ten:

     -  Zum Wiederherstellen des Anzeigemodus sollte vor dem Verlassen
        resetshellmode() aufgerufen werden.

     -  Bei Cursor-Adressierung sollte nach dem Starten entercamode und
        vor dem Verlassen exitcamode ausgegeben werden.

     -  Bei Shell-Escape-Sequenzen sollte vor dem Aufrufen der Shell
        exitcamode ausgegeben und resetshellmode() aufgerufen werden;
        nach der Rückkehr aus der Shell sollte resetprogmode() aufgerufen
        und entercamode ausgegeben werden.

     Alle parametrisierten Terminaleigenschaften, die in terminfo(4) defi-
     niert sind, können an tparm() weitergegeben werden. Einige Implemen-
     tierungen erstellen eigene Eigenschaften, erstellen Eigenschaften für
     Nicht-Terminalgeräte oder definieren die in terminfo(4) beschriebenen
     Eigenschaften neu. Diese Vorgehensweise ist nicht korrekt, da tparm()
     diese benutzerdefinierten Strings möglicherweise nicht interpretieren
     kann.

SIEHE AUCH
     curses(3X), defprogmode(3X), tgetent(3X), putp(3X), terminfo(4),
     term(5).



























Seite 2                      Reliant UNIX 5.44               Gedruckt 11/98