ripoffline(3xcurses) [opensolaris 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 nega- tive). 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.11 5 Jun 2002 ripoffline(3XCURSES)
Check Out this Related Man Page
initscr(3XCURSES) X/Open Curses Library Functions initscr(3XCURSES) NAME
initscr, newterm - screen initialization functions 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> WINDOW *initscr(void); SCREEN *newterm(char *type, FILE *outfp, FILE *infp); PARAMETERS
type Is a string defining the terminal type to be used in place of TERM. outfp Is a pointer to a file to be used for output to the terminal. infp Is the pointer to a file to be used for input to the terminal. DESCRIPTION
The initscr() function initializes X/Open Curses data structures, determines the terminal type, and ensures the first call to refresh(3XCURSES) clears the screen. The newterm() function opens a new terminal with each call. It should be used instead of initscr() when the program interacts with more than one terminal. It returns a variable of type SCREEN, which should be used for later reference to that terminal. Before program termi- nation, endwin() should be called for each terminal. The only functions that you can call before calling initscr() or newterm() are filter(3XCURSES), ripoffline(3XCURSES), slk_init(3XCURSES), and use_env(3XCURSES). RETURN VALUES
On success, the initscr() function returns a pointer to stdscr; otherwise, initscr() does not return. On success, the newterm() function returns a pointer to the specified terminal; otherwise, a null pointer is returned. ERRORS
None. ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Interface Stability |Standard | +-----------------------------+-----------------------------+ |MT-Level |Unsafe | +-----------------------------+-----------------------------+ SEE ALSO
del_curterm(3XCURSES), delscreen(3XCURSES), doupdate(3XCURSES), endwin(3XCURSES), filter(3XCURSES), libcurses(3XCURSES), slk_attroff(3XCURSES), use_env(3XCURSES), attributes(5), standards(5) SunOS 5.11 5 Jun 2002 initscr(3XCURSES)