curs_deleteln(S)

curs_deleteln: deleteln, wdeleteln, insdelln, winsdelln, insertln, winsertln -- delete and insert lines in a curses window

Syntax

cc ... -lcurses

#include <curses.h>

int deleteln(void);
int wdeleteln(WINDOW *win);
int insdelln(int n);
int winsdelln(WINDOW *win, int n);
int insertln(void);
int winsertln(WINDOW *win);

Description

The routines deleteln(S) and wdeleteln(S) delete the line at the cursor in the window. All lines below the current line are moved up one line, and the bottom line of the window is cleared. The cursor position does not change. (This does not imply use of a hardware delete line feature.)

The routines insdelln(S) and winsdelln(S), for positive n, insert n lines into the specified window above the current line. The n bottom lines are lost. For negative n, they delete n lines (starting with the one at the cursor) and move the remaining lines up. The bottom n lines are cleared. The current cursor position remains the same.

The routines insertln(S) and winsertln(S) insert a blank line above the current line and the bottom line is lost. (This does not imply use of a hardware insert line feature.)

Return values

All routines return the integer ERR on failure and an integer value other than ERR on successful completion.

Warning

The header file curses.h automatically includes the header files stdio.h and unctrl.h.

All the routines but winsdelln( ) can be macros.

Files

/usr/lib/libcurses.a: the library

Standards conformance

insdelln(S), winsdelln(S), deleteln(S), wdeleteln(S), insertln(S), and winsertln(S) are not part of any currently supported standard; they were developed by UNIX System Laboratories, Inc. and are maintained by The SCO Group.