ncurses 4.1
[ncurses.git] / man / curs_move.3x
1 .TH curs_move 3X ""
2 .SH NAME
3 \fBmove\fR, \fBwmove\fR - move \fBcurses\fR window cursor
4 .SH SYNOPSIS
5 \fB#include <curses.h>\fR
6
7 \fBint move(int y, int x);\fR
8 .br
9 \fBint wmove(WINDOW *win, int y, int x);\fR
10 .br
11 .SH DESCRIPTION
12 These routines move the cursor associated with the window to line \fIy\fR and
13 column \fIx\fR.  This routine does not move the physical cursor of the terminal
14 until \fBrefresh\fR is called.  The position specified is relative to the upper
15 left-hand corner of the window, which is (0,0).
16 .SH RETURN VALUE
17 These routines return \fBERR\fR upon failure and OK (SVr4
18 specifies only "an integer value other than \fBERR\fR") upon successful
19 completion.
20 .SH NOTES
21 Note that \fBmove\fR may be a macro.
22 .SH PORTABILITY
23 These functions are described in the XSI Curses standard, Issue 4.  The
24 standard specifies that if (y,x) is within a multi-column character, the cursor
25 is moved to the first column of that character; however, this implementation
26 does not yet support the extended-level XSI multi-byte characters.
27 .SH SEE ALSO
28 \fBcurses\fR(3X), \fBcurs_refresh\fR(3X)
29 .\"#
30 .\"# The following sets edit modes for GNU EMACS
31 .\"# Local Variables:
32 .\"# mode:nroff
33 .\"# fill-column:79
34 .\"# End: