insertln(3XCURSES) X/Open Curses Library Functions insertln(3XCURSES)NAME
insertln, winsertln - insert a line in a 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 insertln(void);
int winsertln(WINDOW *win);
PARAMETERS
win Is a pointer to the window in which to insert the line.
DESCRIPTION
The insertln() and winsertln() functions insert a blank line before the
current line in stdscr or win, respectively. The new line becomes the
current line. The current line and all lines after it in the window
are moved down one line. The bottom line in the window is discarded.
RETURN VALUES
On success, these functions return OK. Otherwise, they return ERR.
ERRORS
None.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Interface Stability │Committed │
├─────────────────────────────┼─────────────────────────────┤
│MT-Level │Unsafe │
├─────────────────────────────┼─────────────────────────────┤
│Standard │See standards(5). │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSObkgdset(3XCURSES), deleteln(3XCURSES), insdelln(3XCURSES),
libcurses(3XCURSES), attributes(5), standards(5)SunOS 5.11 5 Jun 2002 insertln(3XCURSES)