X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_refresh.3x.html;h=1e3fc963d870b5782f0f7bec019cc42ffd83977f;hp=b739e0750a7d438c282094b077fb1b6c210431a2;hb=c3b21f65a2687f3894a0d3217006c23f162c893a;hpb=027d0c57c4c4d6690e8d8727888d3282dbe9aa86 diff --git a/doc/html/man/curs_refresh.3x.html b/doc/html/man/curs_refresh.3x.html index b739e075..1e3fc963 100644 --- a/doc/html/man/curs_refresh.3x.html +++ b/doc/html/man/curs_refresh.3x.html @@ -1,6 +1,6 @@ @@ -45,14 +45,12 @@ - -
+
doupdate, redrawwin, refresh, wnoutrefresh, wredrawln, wrefresh - refresh curses windows and lines --
+
#include <curses.h> int refresh(void); @@ -63,8 +61,9 @@ int wredrawln(WINDOW *win, int beg_line, int num_lines); --
+
+ +
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,37 +126,34 @@ 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. --
+
Note that refresh and redrawwin may be macros. --
+
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. --
+
curses(3x), curs_outopts(3x) curs_variables(3x). @@ -165,7 +164,13 @@