INSDELLN(3XCURSES) X/Open Curses Library Functions 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 | Standard |
+--------------------+-----------------+
|MT-Level | Unsafe |
+--------------------+-----------------+

SEE ALSO

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

June 5, 2002 INSDELLN(3XCURSES)