mvcur.3x (2010 09)

m
mvcur(3X) mvcur(3X)
(ENHANCED CURSES)
NAME
mvcur — output cursor movement commands to the terminal
SYNOPSIS
#include <curses.h>
int mvcur(int oldrow, int oldcol, int newrow, int newcol);
DESCRIPTION
The mvcur() function outputs one or more commands to the terminal that move the terminal’s cursor to
(newrow, newcol), an absolute position on the terminal screen. The (oldrow, oldcol) arguments specify
the former cursor position. Specifying the former position is necessary on terminals that do not provide
coordinate-based movement commands. On terminals that provide these commands, Curses may select a
more efficient way to move the cursor based on the former position. If (newrow, newcol) is not a valid
address for the terminal in use,
mvcur() fails. If (oldrow, oldcol) is the same as (newrow, newcol), then
mvcur() succeeds without taking any action. If
mvcur() outputs a cursor movement command, it
updates its information concerning the location of the cursor on the terminal.
RETURN VALUE
Upon successful completion,
mvcur() returns OK. Otherwise, it returns ERR.
ERRORS
No errors are defined.
APPLICATION USAGE
After use of
mvcur(), the model Curses maintains of the state of the terminal might not match the
actual state of the terminal. The application should touch and refresh the window before resuming con-
ventional use of Curses.
SEE ALSO
doupdate(3X), is_linetouched(3X), <curses.h>.
CHANGE HISTORY
First released in X/Open Curses, Issue 4.
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1