NAME
doupdate, refresh, wnoutrefresh, wrefresh — refresh windows and lines
SYNOPSIS
#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 specified window. The functions position the
terminal's cursor at the cursor 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 commands to perform any required changes.
RETURN VALUE
Upon successful completion, these functions return OK.
Otherwise they return ERR.
ERRORS
No errors are defined.
APPLICATION USAGE
Refreshing an entire window is typically more efficient than refreshing
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.
CHANGE HISTORY
First released in X/Open Curses, Issue 4.
This entry is a merger of the X/Open Curses, Issue 3 entries
refresh()
and
wnoutrefresh().
The
DESCRIPTION
is rewritten for clarity and the argument list for the
doupdate()
and
refresh()
functions is explicitly declared as void.
Otherwise the functionality is identical to that defined in X/Open Curses, Issue 3.
Printable version
