|Linux & Unix Commands - Search Man Pages
CURSES_REFRESH(3) BSD Library Functions Manual CURSES_REFRESH(3)
curses_refresh, refresh, wrefresh, wnoutrefresh, doupdate, leaveok, flushok -- curses termi-
nal update routines
Curses Library (libcurses, -lcurses)
leaveok(WINDOW *win, boolf flag);
flushok(WINDOW *win, boolf flag);
These functions update the terminal with the contents of stdscr or of the specified win-
The refresh() function causes curses to propagate changes made to stdscr to the terminal
display. Any changes made to subwindows of stdscr are also propagated.
The wrefresh() function is the same as the refresh() function, excepting that changes are
propagated to the terminal from the window specified by win.
The wnoutrefresh() function performs the internal processing required by curses to determine
what changes need to be made to synchronise the internal screen buffer and the terminal but
does not modify the terminal display.
The doupdate() function updates the terminal display to match the internal curses represen-
tation of the display.
The wnoutrefresh() and doupdate() functions can be used together to speed up terminal
redraws by deferring the actual terminal updates until after a batch of updates to multiple
windows has been done.
The refresh() function is equivalent to wnoutrefresh(stdscr) followed by doupdate().
The leaveok() function determines whether refresh operations may leave the screen cursor in
an arbitrary position on the screen. Setting flag to FALSE ensures that the screen cursor
is positioned at the current cursor position after a refresh operation has taken place.
The flushok() function is used to determine whether or not the screen's output file descrip-
tor will be flushed on refresh. Setting flag to TRUE will cause the output to be flushed.
Functions returning pointers will return NULL if an error is detected. The functions that
return an int will return one of the following values:
OK The function completed successfully.
ERR An error occurred in the function.
curses_pad(3), curses_touch(3), getch(3)
Calling wrefresh() on a new, unchanged window has no effect.
The NetBSD Curses library complies with the X/Open Curses specification, part of the Single
The Curses package appeared in 4.0BSD.
BSD March 26, 2003 BSD
All times are GMT -4. The time now is 12:04 PM.