curses_refresh(3) [netbsd man page]

CURSES_REFRESH(3)					   BSD Library Functions Manual 					 CURSES_REFRESH(3)

NAME

     curses_refresh, refresh, wrefresh, wnoutrefresh, doupdate, leaveok, flushok -- curses terminal update routines

LIBRARY

     Curses Library (libcurses, -lcurses)

SYNOPSIS

     #include <curses.h>

     int
     refresh(void);

     int
     wrefresh(WINDOW *win);

     int
     wnoutrefresh(WINDOW *win);

     int
     doupdate(void);

     int
     leaveok(WINDOW *win, boolf flag);

     int
     flushok(WINDOW *win, boolf flag);

DESCRIPTION

     These functions update the terminal with the contents of stdscr or of the specified window(s).

     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 speci-
     fied 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 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 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 descriptor will be flushed on refresh.  Setting flag to
     TRUE will cause the output to be flushed.

RETURN VALUES

     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.

SEE ALSO

     curses_pad(3), curses_touch(3), getch(3)

NOTES

     Calling wrefresh() on a new, unchanged window has no effect.

STANDARDS

     The NetBSD Curses library complies with the X/Open Curses specification, part of the Single Unix Specification.

HISTORY

     The Curses package appeared in 4.0BSD.

BSD
								  March 26, 2003							       BSD

Check Out this Related Man Page

doupdate(3XCURSES)					  X/Open Curses Library Functions					doupdate(3XCURSES)

NAME

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

SYNOPSIS

       cc [ flag... ] file... -I /usr/xpg4/include -L /usr/xpg4/lib 
       -R /usr/xpg4/lib -lcurses [ library... ]

       c89 [ flag... ] file... -lcurses [ library... ]

       #include <curses.h>

       int doupdate(void);

       int refresh(void);

       int wnoutrefresh(WINDOW *win);

       int wrefresh(WINDOW *win);

DESCRIPTION

       The  refresh() and wrefresh() functions copy stdscr and	win, respectively, to the terminal screen. These functions call the wnoutrefresh()
       function to copy the specified  window to curscr and the doupdate() function 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(3XCURSES) is enabled  (in which case, the cur-
       sor is placed in a position that X/Open Curses finds  convenient).

       When outputting several windows at once, it is often more efficient to call the wnoutrefresh() and doupdate() functions directly.   A  call
       to  wnoutrefresh()  for	each window, 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 the global variable  curscr, the screen is immediately cleared and repainted from scratch.

       For details on how the wnoutrefresh() function handles overlapping  windows with broad glyphs, see the Overlapping Windows section  of  the
       curses(3XCURSES) reference manual page.

PARAMETERS

       win	Is a pointer to the window in which to refresh.

RETURN VALUES

       On success, these functions return OK. Otherwise, they return ERR.

ERRORS

       None.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |Unsafe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       clearok(3XCURSES), curses(3XCURSES), libcurses(3XCURSES), prefresh(3XCURSES), redrawwin(3XCURSES), attributes(5), standards(5)

SunOS 5.10							    5 Jun 2002							doupdate(3XCURSES)

Linux and UNIX Man Pages

curses_refresh(3) [netbsd man page]

Check Out this Related Man Page