doupdate(3X)

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.

SEE ALSO

clearok(3X), redrawwin(3X), <curses.h>.

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.