curs_deleteln(3X)

NAME
deleteln, wdeleteln, insertln, winsertln, insdelln, winsdelln - delete or insert lines in a curses window

SYNOPSIS
#include <curses.h>

int deleteln(void);
int wdeleteln(WINDOW * win);

int insertln(void);
int winsertln(WINDOW * win);

int insdelln(int n);
int winsdelln(WINDOW * win, int n);

DESCRIPTION
wdeleteln deletes the line at the cursor in win; all lines below it move up one line. curses then fills the bottom line of win with the blank character configured by wbkgdset(3X) (wide-character API users: wbkgrndset(3X)). The cursor position does not change.

winsertln inserts a line of blank characters above the line at the cursor in win; the content of the window's bottom line is lost. The cursor position does not change.

winsdelln inserts or deletes n lines in win as n is positive or negative, respectively, as if by repeatedly calling winsertln or wdeleteln.

ncurses(3X) describes the variants of these functions.

RETURN VALUE
These functions return OK on success and ERR on failure.

In ncurses, they fail if win is NULL.

NOTES
All of these functions except winsdelln may be implemented as macros.

These functions do not require the terminal to possess hardware line deletion or insertion capabilities. Even if available, by default curses does not use them; see idlok(3X).

PORTABILITY
X/Open Curses, Issue 4 describes these functions. It specifies no error conditions for them.

SVr4 curses describes a successful return value only as “an integer value other than ERR”.

HISTORY
4BSD (1980) curses introduced wdeleteln and winsertln.

SVr3.1 (1987) added winsdelln.

SEE ALSO
curses(3X)