carta
wmove(3ncurses)

wmove3ncurses

Move cursor in a curses window

Part of move(3ncurses).

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(3NCURSES) is called. The position (y, x) is relative to the upper left-hand corner of the window, which has coordinates (0, 0). ncurses(3NCURSES) 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.

In ncurses, wmove fails if win is NULL.

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”.

History

  • Debian 13 (Trixie): the text shown here
  • Debian 12 (Bookworm)
  • Debian 11 (Bullseye)
  • Debian 10 (Buster)
  • Debian 9 (Stretch) to Debian 7 (Wheezy)
  • Debian 6.0 (Squeeze) to Debian 4.0 (Etch)
  • Debian 3.1 (Sarge)
  • Debian 3.0 (Woody)

History

4BSD (1980) introduced these functions.

From ncurses-doc 6.5+20250216-2 in Debian 13 (Trixie). Parsed by carta from the page's man source.