Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
curs_move(3X)			 Library calls			 curs_move(3X)

NAME
       move, wmove - 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).	  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
       4BSD (1980) introduced these functions.

SEE ALSO
       curses(3X), curs_refresh(3X)

ncurses	6.6			  2025-04-05			 curs_move(3X)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=curs_move&sektion=3&manpath=FreeBSD+15.1-RELEASE+and+Ports.quarterly>

home | help