curs_move.3x - Man Page

move cursor in a curses window

Synopsis

#include <curses.h>

int move(int y, int x);
int wmove(WINDOW *win, int y, int x);

Description

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). ncurses(3X) describes the move variant of this function.

Return Value

These functions return OK on success and ERR on failure.

They fail if the position (y, x) is outside the window boundaries.

wmove fails if its WINDOW pointer argument is NULL.

Notes

move may be implemented as a macro.

Portability

X/Open Curses, Issue 4 describes these functions.

See Also

curses(3X), curs_refresh(3X)

Referenced By

The man pages move.3x(3) and wmove.3x(3) are aliases of curs_move.3x(3).

2024-04-27 ncurses 6.5 Library calls