- NetBSD Manual Pages
CURSES_REFRESH(3) NetBSD Library Functions Manual CURSES_REFRESH(3)
Powered by man-cgi (2021-06-01).
Maintained for NetBSD
by Kimmo Suominen.
Based on man-cgi by Panagiotis Christias.
curses_refresh, refresh, wrefresh, wnoutrefresh, doupdate, immedok,
flushok, leaveok, is_leaveok -- curses terminal update routines
Curses Library (libcurses, -lcurses)
immedok(WINDOW *win, boolf flag);
flushok(WINDOW *win, boolf flag);
leaveok(WINDOW *win, boolf flag);
is_leaveok(const WINDOW *win);
These functions update the terminal with the contents of stdscr or of the
The refresh() function causes curses to propagate changes made to stdscr
to the terminal display. Any changes made to subwindows of stdscr are
The wrefresh() function is the same as the refresh() function, excepting
that changes are propagated to the terminal from the window specified by
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
The doupdate() function updates the terminal display to match the inter-
nal curses representation 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
The immedok() function determines whether the screen is refreshed when-
ever the window is changed. The initial state is FALSE.
The flushok() function is used to determine whether or not the screen's
output file descriptor will be flushed on refresh. Setting flag to TRUE
will cause the output to be flushed.
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 cur-
sor position after a refresh operation has taken place. The is_leaveok()
function returns the setting.
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 Unix Specification.
The Curses package appeared in 4.0BSD. The is_leaveok() function is a
ncurses extension to the Curses library and was added in NetBSD 8.0.
NetBSD 8.1 January 2, 2017 NetBSD 8.1