HPlogo MPE/iX Developer's Kit Reference Manual Volume 2: HP 3000 MPE/iX Computer Systems > Chapter 4 CURSES

refresh wrefresh doupdate wnoutrefresh

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Index

The refresh set of routines is used to copy a window data structure to a physical window.

Syntax

   #include <curses.h>



   int refresh();

   int wrefresh(WINDOW *win);



   int doupdate();



   int wnoutrefresh(WINDOW *win);

Parameters

win

A pointer to the window in which to refresh.

Return Values

OK

Successful completion.

ERROR

An error occurred.

Description

The refresh() and wrefresh() routines copy stdscr and win, respectively, to the terminal screen. These routines call the wnoutrefresh() routine to copy the specified window to curscr and the doupdate() routine to do the actual update. The physical cursor is mapped to the same position as the logical cursor of the last window to update curscr, unless leaveok() is enabled (in which case, the cursor is placed in a position that CURSES finds convenient).

When outputting several windows at once, it is often more efficient to call the wnoutrefresh() and doupdate() routines directly. A call to wnoutrefresh()for each window first, followed by only one call to doupdate() to update the screen, results in one burst of output, fewer characters sent, and less CPU time used.

If the win parameter to wrefresh() is global variable curscr, the screen is immediately cleared and repainted from scratch.

Implementation Considerations

Identical to XPG/3

See Also

leaveok(), pnoutrefresh(), prefresh(), redrawln(), redrawwin()

Portability

HP-UX, UNIX System V, XPG/3

Feedback to webmaster