opensolaris man page for insertln

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  dis-
       carded.

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	     |Standard			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |Unsafe			   |
       +-----------------------------+-----------------------------+

SEE ALSO
       bkgdset(3XCURSES), deleteln(3XCURSES), insdelln(3XCURSES), libcurses(3XCURSES), attributes(5), standards(5)

SunOS 5.11							    5 Jun 2002							insertln(3XCURSES)