|
HTML rendering created 2026-01-16 by Michael Kerrisk, author of The Linux Programming Interface. For details of in-depth Linux/UNIX system programming training courses that I teach, look here. Hosting by jambit GmbH. |
|
|
NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | NOTES | PORTABILITY | HISTORY | SEE ALSO | COLOPHON |
|
|
|
curs_deleteln(3X) Library calls curs_deleteln(3X)
deleteln, wdeleteln, insertln, winsertln, insdelln, winsdelln -
delete or insert lines in a curses window
#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);
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 background character configured by wbkgdset(3X) (wide-
character API users: wbkgrndset(3X)). 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
negative, respectively, as if by repeatedly calling winsertln or
wdeleteln. winsdelln(..., 0) performs no operation.
These functions return OK on success and ERR on failure.
In ncurses, they fail if win is NULL.
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).
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”.
4BSD (1980) introduced deleteln, wdeleteln, insertln, and
winsertln.
SVr3.1 (1987) added insdelln and winsdelln.
curses(3X)
This page is part of the ncurses (new curses) project.
Information about the project can be found at
⟨https://invisible-island.net/ncurses/ncurses.html⟩. If you have a
bug report for this manual page, send it to bug-ncurses@gnu.org.
This page was obtained from the tarball ncurses-6.6.tar.gz fetched
from ⟨https://ftp.gnu.org/gnu/ncurses/⟩ on 2026-01-16. If you
discover any rendering problems in this HTML version of the page,
or you believe there is a better or more up-to-date source for the
page, or you have corrections or improvements to the information
in this COLOPHON (which is not part of the original manual page),
send a mail to man-pages@man7.org
ncurses @NCURSES_MAJOR@.@NCU... 2025-07-05 curs_deleteln(3X)
|
HTML rendering created 2026-01-16 by Michael Kerrisk, author of The Linux Programming Interface. For details of in-depth Linux/UNIX system programming training courses that I teach, look here. Hosting by jambit GmbH. |
|