Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ doupdate(3X) — Reliant UNIX 5.44c4

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

clearok(3X)

curses(3X)

redrawwin(3X)

curses(5)

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

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026