Jump to content United States-English
HP.com Home Products and Services Support and Drivers Solutions How to Buy
» Contact HP
More options
HP.com home
HP-UX Reference > D


HP-UX 11i Version 3: February 2007

Technical documentation

» Feedback
Content starts here

 » Table of Contents

 » Index


doupdate, refresh, wnoutrefresh, wrefresh — refresh windows and lines


#include <curses.h>

int doupdate(void);

int refresh(void);

int wnoutrefresh(WINDOW *win);

int wrefresh(WINDOW *win);


The refresh() and wrefresh() 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() 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 commands to perform any required changes.


Upon successful completion, these functions return OK. Otherwise they return ERR.


No errors are defined.


Refreshing an entire window is typically more efficient than refreshing 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.


clearok(3X), redrawwin(3X), <curses.h>.


First released in X/Open Curses, Issue 4.

This entry is a merger of the X/Open Curses, Issue 3 entries refresh() and wnoutrefresh(). The DESCRIPTION is rewritten for clarity and the argument list for the doupdate() and refresh() functions is explicitly declared as void. Otherwise the functionality is identical to that defined in X/Open Curses, Issue 3.

Printable version
Privacy statement Using this site means you accept its terms Feedback to webmaster
© 1983-2007 Hewlett-Packard Development Company, L.P.