doupdate(3X) doupdate(3X)
NAME
doupdate, refresh, wnoutrefresh, wrefresh - refresh windows and lines
SYNOPSIS
cc [flag ...] file ... -lcurses [library ...]
#include <curses.h>
int doupdate(void);
int refresh(void);
int wnoutrefresh(WINDOW *win);
int wrefresh(WINDOW *win);
DESCRIPTION
The refresh() and wrefresh() functions refresh the current or speci-
fied window. The functions position the terminal's cursor at the cur-
sor position of the window, except that if the leaveok() mode has been
enabled, they may leave the cursor at an arbitrary position.
The wnoutrefresh() function determines which parts of the terminal may
need updating. The doupdate() function sends to the terminal the com-
mands to perform any required changes.
RETURN VALUE
Upon successful completion, these functions return OK. Otherwise, they
return ERR.
ERRORS
No errors are defined.
NOTES
Refreshing an entire window is typically more efficient than refresh-
ing several subwindows separately. An efficient sequence is to call
wnoutrefresh() on each subwindow that has changed, followed by a call
to doupdate(), which updates the terminal.
The refresh() or wrefresh() function (or wnoutrefresh() followed by
doupdate()) must be called to send output to the terminal, as other
Curses functions merely manipulate data structures.
SEE ALSO
clearok(3X), curses(3X), redrawwin(3X), curses(5).
Page 1 Reliant UNIX 5.44 Printed 11/98