move3
Move cursor in a curses window
Part of curs_move(3).
Usage
#include <curses.h>
int move(int y, int x); int wmove(WINDOW * win, int y, int x);
Overview
wmove relocates the cursor associated with the curses window win to line y and column x. The terminal's cursor does not move until refresh(3X) is called. The position (y, x) is relative to the upper left-hand corner of the window, which has coordinates (0, 0). move similarly moves the cursor in the stdscr window.
Return value
These functions return OK on success and ERR on failure. In ncurses, these functions fail if
•
|
|
|---|---|
•
|
|
•
|
the position (y, x) is outside the window boundaries. |
Notes
move may be implemented as a macro.
Portability
X/Open Curses Issue 4 describes these functions. It specifies no error conditions for them.
SVr4 describes a successful return value only as “an integer value other than ERR”.
Releases
83 releases since FreeBSD 2.2.2-RELEASE; the text changed 10 times.