get_wch(3X)                                                     get_wch(3X)

NAME
     getwch, mvgetwch, mvwgetwch, wgetwch - Ein Wide-Character von
     einem Terminal abrufen

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

     #include <curses.h>

     int getwch(wintt *ch);

     int mvgetwch(int y, int x, wintt *ch);

     int mvwgetwch(WINDOW *win, int y, int x, wintt *ch);

     int wgetwch(WINDOW *win, wintt *ch);

BESCHREIBUNG
     Diese Funktionen lesen ein Zeichen von dem Terminal, das dem aktuellen
     oder angegebenen Fenster zugeordnet ist. Wenn keypad() aktiviert ist,
     setzen diese Funktionen beim Drücken einer Funktionstaste das Objekt,
     auf das ch zeigt, auf den entsprechenden, in <curses.h> [siehe
     curses(5)] definierten Wert KEY und geben KEYCODEYES 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 jedes Zeichen direkt auf
     dem Bildschirm wiedergegeben, so als wäre es als ein Eingabeargument
     für addwch() angegeben worden; ausgenommen hiervon sind die folgenden
     Zeichen:

     <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

get_wch(3X)                                                     get_wch(3X)

RÜCKGABEWERT
     Wenn diese Funktionen das Drücken einer Funktionstaste erfolgreich
     melden, geben sie den Wert KEYCODEYES zurück. Wenn sie erfolgreich
     ein Wide-Character melden, geben sie den Wert OK zurück. Andernfalls
     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
     beep(3X), cbreak(3X), curses(3X), inswch(3X), keypad(3X), move(3X),
     curses(5), wchar(5).

































Seite 2                      Reliant UNIX 5.44               Gedruckt 11/98