man7.org > Linux > man-pages

Linux/UNIX system programming training

curs_move(3x) — Linux manual page

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | NOTES | PORTABILITY | HISTORY | SEE ALSO | COLOPHON 

curs_move(3X)                 Library calls                 curs_move(3X)

NAME         top

       move, wmove - move cursor in a curses window

SYNOPSIS         top

       #include <curses.h>

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

DESCRIPTION         top

       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         top

       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         top

       move may be implemented as a macro.

PORTABILITY         top

       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         top

       4BSD (1980) introduced these functions.

SEE ALSO         top

       curses(3X), curs_refresh(3X)

COLOPHON         top

       This page is part of the ncurses (new curses) project.
       Information about the project can be found at 
       ⟨https://invisible-island.net/ncurses/ncurses.html⟩.  If you have a
       bug report for this manual page, send it to bug-ncurses@gnu.org.
       This page was obtained from the tarball ncurses-6.6.tar.gz fetched
       from ⟨https://ftp.gnu.org/gnu/ncurses/⟩ on 2026-01-16.  If you
       discover any rendering problems in this HTML version of the page,
       or you believe there is a better or more up-to-date source for the
       page, or you have corrections or improvements to the information
       in this COLOPHON (which is not part of the original manual page),
       send a mail to man-pages@man7.org

ncurses @NCURSES_MAJOR@.@NCU... 2025-04-05                  curs_move(3X)

HTML rendering created 2026-01-16 by Michael Kerrisk, author of The Linux Programming Interface.

For details of in-depth Linux/UNIX system programming training courses that I teach, look here.

Hosting by jambit GmbH.

Cover of TLPI