deleteln(3NCURSES) Library calls deleteln(3NCURSES)
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 back-
ground character configured by wbkgdset(3NCURSES) (wide-character API
users: wbkgrndset(3NCURSES)). The cursor position does not change.
winsertln inserts a new, empty line of characters above the line at the
cursor in win, shifting the existing lines down by one. The content of
the window's bottom line is lost; curses fills the new line with the
background character. The cursor position does not change.
winsdelln inserts or deletes n lines in win as n is positive or nega-
tive, respectively, as if by repeatedly calling winsertln or wdeleteln.
ncurses(3NCURSES) 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(3NCURSES).
PORTABILITY
X/Open Curses Issue 4 describes these functions. It specifies no error
conditions for them.
SVr4 describes a successful return value only as “an integer value other
than ERR”.
HISTORY
4BSD (1980) introduced deleteln, wdeleteln, insertln, and winsertln.
SVr3.1 (1987) added insdelln and winsdelln.
SEE ALSO
ncurses(3NCURSES)
ncurses 6.5 2025-02-01 deleteln(3NCURSES)
Generated by dwww version 1.16 on Sat Oct 3 05:20:19 CEST 2026.