clear(3xcurses) [opensolaris man page]

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

NAME

       clear, erase, wclear, werase - clear a window

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 clear(void);

       int erase(void);

       int wclear(WINDOW *win);

       int werase(WINDOW *win);

DESCRIPTION

       The  clear()  and  erase()  functions clear stdscr,  destroying its previous contents. The wclear() and werase() functions perform the same
       action,	but clear the window specified by win instead of stdscr.

       The clear() and wclear() functions also call the clearok() function. This function clears and redraws the entire screen on the next call to
       refresh(3XCURSES) or wrefresh(3XCURSES) for the window.

       The current background character (and attributes) is used to clear the screen.

PARAMETERS

       win    Is a pointer to the window that is to be cleared.

ERRORS

       OK     Successful completion.

       ERR    An error occurred.

ATTRIBUTES

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

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

SEE ALSO

       bkgdset(3XCURSES),  clearok(3XCURSES),  clrtobot(3XCURSES), clrtoeol(3XCURSES), doupdate(3XCURSES), libcurses(3XCURSES), refresh(3XCURSES),
       wrefresh(3XCURSES), attributes(5), standards(5)

SunOS 5.11							    5 Jun 2002							   clear(3XCURSES)

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)