Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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, respec-
       tively, 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	cursor
       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 doup-
       date() 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),	  pre-
       fresh(3XCURSES),	redrawwin(3XCURSES), attributes(5), standards(5)

SunOS 5.10			  5 Jun	2002		    doupdate(3XCURSES)

NAME | SYNOPSIS | DESCRIPTION | PARAMETERS | RETURN VALUES | ERRORS | ATTRIBUTES | SEE ALSO

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=doupdate&sektion=3xcurses&manpath=SunOS+5.10>

home | help