ripoffline(3xcurses) [sunos man page]
ripoffline(3XCURSES) X/Open Curses Library Functions ripoffline(3XCURSES) NAME
ripoffline - reserve screen line for dedicated purpose 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 ripoffline(int line, int (*init)(WINDOW *win, int width)); PARAMETERS
line determines whether the screen line being reserved comes from the top of stdscr (line is positive) or the bottom (line is negative). init Is a pointer to a function that initializes the one-line window. win Is a pointer to one-line window created by this function. width Is the number of columns in the window pointed to by the win parameter. DESCRIPTION
The ripoffline() function reserves a screen line as a one line window. To use this function, it must be called before you call initscr(3XCURSES) or newterm(3XCURSES). When initscr() or newterm() is called, so is the function pointed to by init. The function pointed to by init takes two arguments: a pointer to the one-line window and the number of columns in that window. This function cannot use the LINES or COLS variables and cannot call wrefresh(3XCURSES) or doupdate(3XCURSES), but may call wnoutrefresh(3XCURSES). RETURN VALUES
The rioffline() function always returns OK. ERRORS
None. ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Interface Stability |Standard | +-----------------------------+-----------------------------+ |MT-Level |Unsafe | +-----------------------------+-----------------------------+ SEE ALSO
doupdate(3XCURSES), initscr(3XCURSES), libcurses(3XCURSES), slk_attroff(3XCURSES), attributes(5), standards(5) SunOS 5.10 5 Jun 2002 ripoffline(3XCURSES)
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)