|
|
#include <curses.h>int ripoffline(int line, int (*init)(WINDOW *win, int columns));
Any call to ripoffline(3curses) must precede the call to initscr(3curses) or newterm(3curses). If line is positive, one line is removed from the beginning of stdscr; if line is negative, one line is removed from the end. Removal occurs during the subsequent call to initscr(3curses) or newterm(3curses). When the subsequent call is made, the function pointed to by init is called with two arguments: a WINDOW pointer to the one-line window that has been allocated and an integer with the number of columns in the window. The initialisation function cannot use the LINES and COLS external variables and cannot call wrefresh(3curses) or doupdate(3curses), but may call wnoutrefresh(3curses).
Up to five lines can be ripped off. Calls to ripoffline(3curses) above this limit have no effect but report success.
When initscr(3curses) or newterm(3curses) calls the initialisation function pointed to by init, the implementation may pass NULL for the WINDOW pointer argument win. This indicates inability to allocate a one-line window for the line that the call to ripoffline(3curses) ripped off. Portable applications should verify that win is not NULL before performing any operation on the window it represents.