curs_refresh(3curses) 맨 페이지 - 윈디하나의 솔라나라

개요

섹션
맨 페이지 이름
검색(S)

curs_refresh(3curses)

curs_refresh(3CURSES)      Curses Library Functions      curs_refresh(3CURSES)

NAME
       curs_refresh,  refresh,  wrefresh,  wnoutrefresh,  doupdate, redrawwin,
       wredrawln - refresh curses windows and lines

SYNOPSIS
       cc [ flag ... ] file ... -lcurses [ library ... ]
       #include <curses.h>

       int refresh(void);


       int wrefresh(WINDOW *win);


       int wnoutrefresh(WINDOW *win);


       int doupdate(void);


       int redrawwin(WINDOW *win);


       int wredrawln(WINDOW *win, int beg_line, int num_lines);

DESCRIPTION
       The refresh() and wrefresh()  routines  (or  wnoutrefresh()  and  doup‐
       date()) must be called to get any output on the terminal, as other rou‐
       tines  merely manipulate data structures. The routine wrefresh() copies
       the named window to the physical terminal screen, taking  into  account
       what  is already there in order to do optimizations. The refresh() rou‐
       tine is the same, using stdscr as the default window. Unless  leaveok()
       has  been  enabled,  the physical cursor of the terminal is left at the
       location of the cursor for that window.


       The wnoutrefresh() and doupdate() routines allow multiple updates  with
       more  efficiency  than  wrefresh() alone. In addition to all the window
       structures, curses keeps two data structures representing the  terminal
       screen:  a  physical screen, describing what is actually on the screen,
       and a virtual screen, describing what the programmer wants to  have  on
       the screen.


       The  routine  wrefresh()  works  by first calling wnoutrefresh(), which
       copies the named window to the virtual screen, and then  calling  doup‐
       date(),  which  compares  the virtual screen to the physical screen and
       does the actual update. If the programmer wishes to output several win‐
       dows at once, a series of calls to wrefresh()  results  in  alternating
       calls  to wnoutrefresh() and doupdate(), causing several bursts of out‐
       put to the screen. By first calling wnoutrefresh() for each window,  it
       is  then  possible to call doupdate() once, resulting in only one burst
       of output, with fewer total characters transmitted and  less  CPU  time
       used. If the  win argument to wrefresh() is the global variable curscr,
       the screen is immediately cleared and repainted from scratch.


       The  redrawwin() routine indicates to curses that some screen lines are
       corrupted and should be thrown away before  anything  is  written  over
       them.  These routines could be used for programs such as editors, which
       want a command to redraw some part of the screen or the entire  screen.
       The routine redrawln() is preferred over redrawwin() where a noisy com‐
       munication line exists and redrawing the entire window could be subject
       to  even  more communication noise. Just redrawing several lines offers
       the possibility that they would show up unblemished.

RETURN VALUES
       All routines return the integer ERR upon failure and an  integer  value
       other than ERR upon successful completion.

ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:

       tab()  box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) ATTRIBUTE TYPEAT‐
       TRIBUTE VALUE _ MT-LevelUnsafe


SEE ALSO
       curs_outopts(3CURSES), curses(3CURSES), attributes(7)

NOTES
       The header <curses.h> automatically includes the headers <stdio.h>  and
       <unctrl.h>.


       Note that refresh() and redrawwin() may be macros.

Oracle Solaris 11.4               31 Dec 1996            curs_refresh(3CURSES)
맨 페이지 내용의 저작권은 맨 페이지 작성자에게 있습니다.
RSS ATOM XHTML 5 CSS3