wmove(3) · carta

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 curses screen has not been initialized,

•: (for wmove) win is a null pointer, or

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

History

FreeBSD 16.0-CURRENT (2026-10-27) to FreeBSD 15.1-RELEASE: the text shown here
FreeBSD 15.0-RELEASE
FreeBSD 14.5-RELEASE
FreeBSD 14.4-RELEASE to FreeBSD 14.2-RELEASE
FreeBSD 14.1-RELEASE to FreeBSD 14.0-RELEASE
FreeBSD 13.5-RELEASE to FreeBSD 13.0-RELEASE
FreeBSD 12.4-RELEASE to FreeBSD 11.0-RELEASE
FreeBSD 10.4-RELEASE to FreeBSD 6.3-RELEASE
FreeBSD 6.2-RELEASE to FreeBSD 5.0-RELEASE
FreeBSD 4.11-RELEASE to FreeBSD 4.0-RELEASE
FreeBSD 3.5.1-RELEASE to FreeBSD 2.2.2-RELEASE