[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]

Technical Reference: Base Operating System and Extensions , Volume 2

ripoffline Subroutine


Reserves a line for a dedicated purpose.


Curses Library (libcurses.a)


ripoffline(int line,
int (*init)(WINDOW *win,
int columns));


The ripoffline subroutine reserves a screen line for use by the application.

Any call to the ripoffline subroutine must precede the call to the initscr or newterm subroutine. If line is positive, one line is removed from the beginning of stdstr; if line is negative, one line is removed from the end. Removal occurs during the subsequent call to the initscr or newterm subroutine. When the subsequent call is made, the subroutine 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 subroutine cannot use the LINES and COLS external variables and cannot call the wrefresh or doupdate subroutine, but may call the wnoutrefresh subroutine.

Up to five lines can be ripped off. Calls to the ripoffline subroutine above this limit have no effect, but report success.



Return Values

The ripoffline subroutine returns OK.


To remove three lines from the top of the screen, enter:

#include <curses.h>



Implementation Specifics

This routine is part of Base Operating System (BOS) Runtime.

Related Information

The doupdate (doupdate, refresh, wnoutrefresh, or wrefresh Subroutines) subroutine, slk_attroff, slk_init (slk_attroff, slk_attr_off, slk_attron, slk_attrset, slk_attr_set, slk_clear, slk_color, slk_init, slk_label, slk_noutrefresh, slk_refresh, slk_restore, slk_set, slk_touch, slk_wset, Subroutine) subroutine, initscr (initscr and newterm Subroutine) subroutine, newterm (newterm Subroutine) subroutine.

Curses Overview for Programming and List of Curses Subroutines in AIX 5L Version 5.1 General Programming Concepts: Writing and Debugging Programs.

[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]