diff options
Diffstat (limited to 'man/curs_move.3x')
| -rw-r--r-- | man/curs_move.3x | 64 |
1 files changed, 47 insertions, 17 deletions
diff --git a/man/curs_move.3x b/man/curs_move.3x index c3b68e813d1c..97e9384f6ce3 100644 --- a/man/curs_move.3x +++ b/man/curs_move.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2018-2023,2024 Thomas E. Dickey * +.\" Copyright 2018-2024,2025 Thomas E. Dickey * .\" Copyright 1998-2010,2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,8 +27,23 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_move.3x,v 1.40 2024/04/27 17:56:05 tom Exp $ -.TH curs_move 3X 2024-04-27 "ncurses @NCURSES_MAJOR@.@NCURSES_MINOR@" "Library calls" +.\" $Id: curs_move.3x,v 1.63 2025/04/05 22:08:55 tom Exp $ +.TH curs_move 3X 2025-04-05 "ncurses @NCURSES_MAJOR@.@NCURSES_MINOR@" "Library calls" +.ie \n(.g \{\ +.ds `` \(lq +.ds '' \(rq +.\} +.el \{\ +.ie t .ds `` `` +.el .ds `` "" +.ie t .ds '' '' +.el .ds '' "" +.\} +. +.de bP +.ie n .IP \(bu 4 +.el .IP \(bu 2 +.. .SH NAME \fB\%move\fP, \fB\%wmove\fP \- @@ -38,7 +53,7 @@ move cursor in a \fIcurses\fR window \fB#include <curses.h> .PP \fBint move(int \fIy\fP, int \fIx\fP); -\fBint wmove(WINDOW *\fIwin\fP, int \fIy\fP, int \fIx\fP); +\fBint wmove(WINDOW * \fIwin\fP, int \fIy\fP, int \fIx\fP); .fi .SH DESCRIPTION .B \%wmove @@ -57,32 +72,47 @@ The position is relative to the upper left-hand corner of the window, which has coordinates (0,\ 0). -\fB\%ncurses\fP(3X) describes the -.B \%move -variant of this function. +.B move +similarly moves the cursor in the +.B \%stdscr +window. .SH RETURN VALUE These functions return .B OK on success and .B ERR on failure. -.PP -They fail if the position +In +.IR \%ncurses , +these functions fail if +.bP +the +.I curses +screen has not been initialized, +.bP +(for +.BR \%wmove ")" +.I win +is a null pointer, +or +.bP +the position .RI ( y , .IR x ) is outside the window boundaries. -.PP -.B \%wmove -fails if its -.I \%WINDOW -pointer argument is -.BR NULL . .SH NOTES .B \%move may be implemented as a macro. .SH PORTABILITY -X/Open Curses, -Issue 4 describes these functions. +X/Open Curses Issue\ 4 describes these functions. +It specifies no error conditions for them. +.PP +SVr4 describes a successful return value only as +\*(``an integer value other than +.IR ERR \*(''. \" Courier roman in source; SVID 4, vol. 3, p. 503 +.SH HISTORY +4BSD (1980) +introduced these functions. .SH SEE ALSO \fB\%curses\fP(3X), \fB\%curs_refresh\fP(3X) |