getch(3X)                                                         getch(3X)

NAME
     getch, wgetch, mvgetch, mvwgetch - Ein Einzelbytezeichen vom Terminal
     abrufen

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

     #include <curses.h>

     int getch(void);

     int mvgetch(int y, int x);

     int mvwgetch(WINDOW *win, int y, int x);

     int wgetch(WINDOW *win);

BESCHREIBUNG
     Diese Funktionen lesen ein Einzelbytezeichen von dem Terminal, das dem
     aktuellen oder angegebenen Fenster zugeordnet ist. Die Ergebnisse sind
     unbestimmt, wenn es sich bei der Eingabe nicht um ein Einzelbytezei-
     chen handelt. Wenn keypad() aktiviert ist, geben diese Funktionen beim
     Drücken einer Funktionstaste den entsprechenden, in <curses.h> defi-
     nierten Wert KEY zurück.

     Die Verarbeitung der Terminaleingabe unterliegt den allgemeinen
     Regeln, die in "X/Open Curses, Issue 4, Version 2, Abschnitt 3.5"
     beschrieben sind.

     Wenn die Echo-Funktion aktiviert ist, wird das Zeichen direkt auf dem
     Bildschirm wiedergegeben, so als wäre es als ein Eingabeargument für
     addch() angegeben worden; ausgenommen hiervon sind die folgenden Zei-
     chen:

     <backspace>, <left-arrow> und das aktuell verwendete Erase-Zeichen:
          Die Eingabe wird wie in "X/Open Curses, Issue 4, Version 2,
          Abschnitt 3.4.3" beschrieben interpretiert, und anschließend wird
          das Zeichen an der entsprechenden Cursor-Position gelöscht, so
          wie beim Aufruf von delch(), nur daß hierbei der Benutzer wie bei
          der Funktion beep() gewarnt wird, wenn der Cursor ursprünglich in
          der ersten Spalte der Zeile stand.

     Funktionstasten:
          Der Benutzer wird auf dieselbe Weise wie bei der Funktion beep()
          gewarnt. Informationen zu den Funktionstasten werden nicht ausge-
          geben.

     Wenn es sich bei dem aktuellen oder angegebenen Fenster nicht um ein
     kleines Fenster (Pad) handelt, und es seit der letzten Aktualisierung
     verschoben oder geändert worden ist, wird das Fenster vor dem Lesen
     eines neuen Zeichens aktualisiert.




Seite 1                      Reliant UNIX 5.44               Gedruckt 11/98

getch(3X)                                                         getch(3X)

RÜCKGABEWERT
     Nach erfolgreicher Ausführung geben die Funktionen getch(), mvgetch(),
     mvwgetch() und wgetch() das Einzelbytezeichen oder den entsprechenden
     Wert KEY zurück. Bei einem Fehler wird ERR zurückgegeben. Wenn der
     Modus nodelay aktiviert ist und keine Daten verfügbar sind, wird ERR
     zurückgegeben.

FEHLER
     Es sind keine Fehlerzuordnungen definiert.

HINWEISE
     Anwendungen sollten die Escape-Taste nicht separat als Einzelzeichen-
     funktion definieren.

     Diese Funktionen sollten nicht zusammen mit dem Modus nocbreak() und
     echo() verwendet werden. Abhängig vom Status, in dem sich das Terminal
     bei Eingabe der einzelnen Zeichen befindet, kann die Anwendung uner-
     wünschte Ergebnisse produzieren.

SIEHE AUCH
     cbreak(3X), curses(3X), doupdate(3X), insch(3X), curses(5).

































Seite 2                      Reliant UNIX 5.44               Gedruckt 11/98