mvcur(3X) mvcur(3X)
NAME
mvcur - Kommandos zur Cursor-Bewegung an das Terminal ausgeben
SYNTAX
cc [flag ...] file ... -lcurses [library ...]
#include <curses.h>
int mvcur(int oldrow, int oldcol, int newrow, int newcol);
BESCHREIBUNG
Die Funktion mvcur() gibt ein oder mehrere Kommando(s) an das Terminal
aus, über das/die der Terminal-Cursor nach (newrow, newcol) verschoben
wird. Hierbei handelt es sich um eine absolute Position auf dem Termi-
nalbildschirm. Die Argumente (oldrow, oldcol) geben die vorherige
Cursor-Position an. Die Angabe der vorherigen Cursor-Position ist auf
Terminals erforderlich, die keine auf Koordinaten basierenden Komman-
dos zur Bewegung des Cursors unterstützen. Auf Terminals, die solche
Kommandos unterstützen, kann Curses eine effizientere Weise zur
Cursor-Bewegung basierend auf der vorherigen Cursor-Position wählen.
Wenn (newrow, newcol) keine gültige Adresse für das verwendete Termi-
nal ist, schlägt mvcur() fehl. Wenn (oldrow, oldcol) identisch mit
(newrow, newcol) ist, kehrt mvcur() zwar ohne Fehler zurück, es wird
jedoch keine Aktion ausgeführt. Wenn mvcur() ein Kommando zur Cursor-
Bewegung ausgibt, werden die Informationen zur Position des Cursors
auf dem Terminal aktualisiert.
RÜCKGABEWERT
Nach erfolgreicher Ausführung gibt mvcur() den Wert OK zurück. Andern-
falls wird ERR zurückgegeben.
FEHLER
Es sind keine Fehlerzuordnungen definiert.
HINWEISE
Nach der Verwendung von mvcur() entspricht das Modell des Terminalsta-
tus innerhalb von Curses möglicherweise nicht mehr dem tatsächlichen
Status des Terminals. Die Anwendung sollte das Fenster als geändert
markieren und aktualisieren, bevor die normale Verwendung von Curses
wiederaufgenommen wird.
SIEHE AUCH
curses(3X), doupdate(3X), islinetouched(3X), curses(5).
Seite 1 Reliant UNIX 5.44 Gedruckt 11/98