NAME
curses_insertln,
insertln, winsertln —
curses insert single line
routines
LIBRARY
library “libcurses”
SYNOPSIS
#include
<curses.h>
int
insertln(void);
int
winsertln(WINDOW
*win);
DESCRIPTION
These functions insert a single line onstdscr or on the
specified window.
The
insertln()
function inserts a blank line before the current line on
stdscr. The current line and all lines below are
moved down one line away from the cursor and the bottom line of the window
is lost.
The
winsertln()
function is the same as the insertln() function,
excepting that the line is inserted on the window
win.
If a scrolling region has been set with the
setscrreg()
or
wsetscrreg()
functions and the current cursor position is inside the scrolling region,
then only the lines from the current line to the bottom of the scrolling
region are moved down and the bottom line of the scrolling region lost.
The functions
insertln()
and winsertln(win) are
equivalent to
insdelln(1)
and
winsdelln(win,
1), respectively.
RETURN VALUES
Functions returning pointers will return
NULL if an error is detected. The functions that
return an int will return one of the following values:
OK- The function completed successfully.
ERR- An error occurred in the function.
SEE ALSO
STANDARDS
The NetBSD Curses library complies with the X/Open Curses specification, part of the Single Unix Specification.
HISTORY
The Curses package appeared in 4.0BSD.