# curs_deleteln 3x

    curs_deleteln(3x)                                     curs_deleteln(3x)

## NAME

           deleteln,  wdeleteln,  insdelln, winsdelln, insertln, win-
           sertln - delete and insert lines in a curses window

## SYNOPSIS

           #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 deleteln and wdeleteln routines delete the line  under
           the cursor in the window; all lines below the current line
           are moved up one line.  The bottom line of the  window  is
           cleared.  The cursor position does not change.

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

           The insertln and winsertln routines insert  a  blank  line
           above the current line and the bottom line is lost.

## RETURN VALUE

           All routines return the integer ERR upon failure and an OK
           (SVr4 specifies only "an integer value  other  than  ERR")
           upon successful completion.

           X/Open  defines  no error conditions.  In this implementa-
           tion, if  the  window  parameter  is  null,  an  error  is
           returned.

## PORTABILITY

           These  functions are described in the XSI Curses standard,
           Issue 4.  The standard specifies that they return  ERR  on
           failure, but specifies no error conditions.

## NOTES

           Note that all but winsdelln may be macros.

           These  routines  do  not require a hardware line delete or
           insert feature in the terminal.  In fact,  they  will  not
           use  hardware  line  delete/insert unless idlok(..., TRUE)
           has been set on the current window.

## SEE ALSO

           curses(3x)

                                                          curs_deleteln(3x)