Go to main content

man pages section 3: Curses Library Functions

Exit Print View

Updated: Thursday, June 13, 2019
 
 

insdelln(3XCURSES)

Name

insdelln, winsdelln - insert/delete lines to/from the window

Synopsis

cc [ flag... ] file... –I /usr/xpg4/include –L /usr/xpg4/lib \
–R /usr/xpg4/lib –lcurses [ library... ]

c89 [ flag... ] file... –lcurses [ library... ]

#include <curses.h>

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

Parameters

n

Is the number of lines to insert or delete (positive n inserts; negative n deletes).

win

Is a pointer to the window in which to insert or delete a line.

Description

The insdelln() and winsdelln() functions insert or delete blank lines in stdscr or win, respectively. When n is positive, n lines are added before the current line and the bottom n lines are lost; when n is negative, n lines are deleted starting with the current line, the remaining lines are moved up, and the bottom n lines are cleared. The position of the cursor does not change.

Return Values

On success, these functions return OK. Otherwise, they return ERR.

Errors

None.

Attributes

See attributes(7) for descriptions of the following attributes:

ATTRIBUTE TYPE
ATTRIBUTE VALUE
Interface Stability
Committed
MT-Level
Unsafe
Standard

See Also

deleteln(3XCURSES), insertln(3XCURSES), libcurses(3XCURSES), attributes(7), standards(7)