ripoffline — reserve a line for a dedicated purpose
int ripoffline(int line, int (*init)(WINDOW *win, int columns));
function reserves a screen line for use by the application.
Any call to
must precede the call to
If line is positive, one line is removed from the beginning of
if line is negative, one line is removed from the end.
Removal occurs during the subsequent call to
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
external variables and cannot call
but may call
Up to five lines can be ripped off. Calls to
above this limit have no effect but report success.
function returns OK.
No errors are defined.
reduces the size of the screen by one line if
eventually uses a line from
to emulate the soft labels. If
rips off a line, it thereby reduces by one the number of lines an application
can reserve by subsequent calls to
Thus, portable applications that use soft label functions should not call
more than four times.
calls the initialisation function pointed to by
the implementation may pass NULL for the
This indicates inability to allocate a one-line window for the line that the
ripped off. Portable applications should verify that
is not NULL before performing any operation on the window it represents.
First released in X/Open Curses, Issue 4.