keyname(3X) keyname(3X)
NAME
keyname, keyname - Namen einer Taste abrufen
SYNTAX
cc [flag ...] file ... -lcurses [library ...]
#include <curses.h>
char *keyname(int c);
char *keyname(wchart c);
BESCHREIBUNG
Die Funktionen keyname() und keyname() generieren einen String, des-
sen Wert die Taste c beschreibt. Das Argument c von keyname() kann ein
8-Bit-Zeichen oder ein Tastencode sein. Das Argument c von keyname()
muß ein Wide-Character sein.
Das Format des Strings richtet sich nach der ersten zutreffenden Zeile
in folgender Tabelle:
______________________________________________________________________
| Eingabe Format des ausgegebenen Strings|
|_____________________________________________________________________|
| Sichtbares Zeichen Das eingegebene Zeichen |
| Steuerzeichen ^X |
| Meta-Zeichen (nur keyname()) M-X |
| In <curses.h> definierter Tasten- KEYname |
| wert (nur keyname()) |
| Keine der oben genannten UNKNOWN KEY |
|_____________________________________________________________________|
Die oben angegebene Schreibweise in Meta-Zeichen wird nur verwendet,
wenn Meta-Zeichen aktiviert sind.
RÜCKGABEWERT
Nach erfolgreicher Ausführung gibt die Funktion keyname() einen Zeiger
auf einen der oben gezeigten Strings zurück. Andernfalls wird ein
Null-Zeiger zurückgegeben.
FEHLER
Es sind keine Fehlerzuordnungen definiert.
HINWEISE
Der Rückgabewert von keyname() und keyname() kann auf einen stati-
schen Bereich zeigen, der durch einen nachfolgenden Aufruf einer der
beiden Funktionen überschrieben wird.
Anwendungen verarbeiten Meta-Zeichen normalerweise ohne sie in einem
Fenster zu speichern. Wenn eine Anwendung Meta-Zeichen in einem Fen-
ster speichert und versucht, diese als Wide-Characters abzurufen, kann
die Funktion keyname() die Meta-Zeichen nicht finden, da Wide-Charac-
ters Meta-Zeichen nicht unterstützen.
Seite 1 Reliant UNIX 5.44 Gedruckt 11/98
keyname(3X) keyname(3X)
SIEHE AUCH
curses(3X), meta(3X), curses(5).
Seite 2 Reliant UNIX 5.44 Gedruckt 11/98