doupdate(3curses)
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(3curses)
and
wrefresh(3curses)
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(3curses)
mode has been enabled, they may leave the cursor at an arbitrary position.
The
wnoutrefresh(3curses)
function determines which parts of the terminal may need updating. The
doupdate(3curses)
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(3curses)
on each subwindow that has changed, followed by a call to
doupdate(3curses),
which updates the terminal.
The
refresh(3curses)
or
wrefresh(3curses)
function (or
wnoutrefresh(3curses)
followed by
doupdate(3curses))
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(3curses),
redrawwin(3curses),
curses(4)
© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004