doupdate(CURSES)

doupdate -- refresh windows and lines

Synopsis

cc [options] file -lcurses

#include <curses.h>

int doupdate(void);

int refresh(void);

int wnoutrefresh(WINDOW *win);

int wrefresh(WINDOW *win);

Description

The refresh(CURSES) and wrefresh(CURSES) 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(CURSES) mode has been enabled, they may leave the cursor at an arbitrary position.

The wnoutrefresh(CURSES) function determines which parts of the terminal may need updating. The doupdate(CURSES) 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.

Usage

Refreshing an entire window is typically more efficient than refreshing several subwindows separately. An efficient sequence is to call wnoutrefresh(CURSES) on each subwindow that has changed, followed by a call to doupdate(CURSES), which updates the terminal.

The refresh(CURSES) or wrefresh(CURSES) function (or wnoutrefresh(CURSES) followed by doupdate(CURSES)) must be called to send output to the terminal, as other Curses functions merely manipulate data structures.

Standards Conformance

The Single UNIX Specification, Version 2; The Open Group.

References

clearok(CURSES), redrawwin(CURSES), curses(F)