mvcur(3X)                                                         mvcur(3X)

NAME
     mvcur - output cursor movement commands to the terminal

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

     #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 effi-
     cient 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 move-
     ment 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.

NOTES
     After use of mvcur(), the model Curses maintains of the state of the
     terminal might not match the actual state of the terminal. The appli-
     cation should touch and refresh the window before resuming conven-
     tional use of Curses.

SEE ALSO
     curses(3X), doupdate(3X), islinetouched(3X), curses(5).
















Page 1                       Reliant UNIX 5.44                Printed 11/98