The refresh and wrefresh routines (or wnoutrefresh and
doupdate) must be called to get actual output to the ter-
minal, as other routines merely manipulate data struc-
@@ -76,6 +75,8 @@
minal is left at the location of the cursor for that win-
dow.
+
+
The wnoutrefresh and doupdate routines allow multiple up-
dates with more efficiency than wrefresh alone. In addi-
tion to all the window structures, curses keeps two data
@@ -108,15 +109,16 @@
see the section on PORTABILITY below for a warning about
exploiting this behavior.)
+
+
The wredrawln routine indicates to curses that some screen
lines are corrupted and should be thrown away before any-
thing is written over them. It touches the indicated
- lines (marking them changed). The routine redrawwin()
+ lines (marking them changed). The routine redrawwin
touches the entire window.
-
Routines that return an integer return ERR upon failure,
and OK (SVr4 only specifies "an integer value other than
ERR") upon successful completion.
@@ -124,47 +126,56 @@
X/Open does not define any error conditions. In this im-
plementation
- wnoutrefresh
- returns an error if the window pointer is
- null, or if the window is really a pad.
+ wnoutrefresh
+ returns an error if the window pointer is null, or
+ if the window is really a pad.
- wredrawln
- returns an error if the associated call to
- touchln returns an error.
+ wredrawln
+ returns an error if the associated call to touchln
+ returns an error.
-
The XSI Curses standard, Issue 4 describes these func-
tions.
- Whether wnoutrefresh() copies to the virtual screen the
- entire contents of a window or just its changed portions
- has never been well-documented in historic curses versions
+ Whether wnoutrefresh copies to the virtual screen the en-
+ tire contents of a window or just its changed portions has
+ never been well-documented in historic curses versions
(including SVr4). It might be unwise to rely on either
behavior in programs that might have to be linked with
other curses implementations. Instead, you can do an ex-
- plicit touchwin() before the wnoutrefresh() call to guar-
- antee an entire-contents copy anywhere.
+ plicit touchwin before the wnoutrefresh call to guarantee
+ an entire-contents copy anywhere.
-