Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

insertln(3) [netbsd man page]

CURSES_INSERTLN(3)					   BSD Library Functions Manual 					CURSES_INSERTLN(3)

NAME
curses_insertln, insertln, winsertln -- curses insert single line routines LIBRARY
Curses Library (libcurses, -lcurses) SYNOPSIS
#include <curses.h> int insertln(void); int winsertln(WINDOW *win); DESCRIPTION
These functions insert a single line on stdscr 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
curses_deleteln(3), curses_insdelln(3), curses_scroll(3) 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. BSD
February 5, 2006 BSD

Check Out this Related Man Page

CURSES_INSDEL(3)					   BSD Library Functions Manual 					  CURSES_INSDEL(3)

NAME
curses_insdelln, insdelln, winsdelln -- curses insert or delete lines routines LIBRARY
Curses Library (libcurses, -lcurses) SYNOPSIS
#include <curses.h> int insdelln(int n); int winsdelln(WINDOW *win, int n); DESCRIPTION
These functions insert or delete lines on stdscr or on the specified window. If insdelln() is called with a positive number in n, then the specified number of lines are inserted before the current line on stdscr. The last n lines of the screen are no longer displayed. If n is negative, then n lines are deleted from stdscr, starting at the current line. The last n lines of stdscr are cleared. The winsdelln() function is the same as the insdelln() function, excepting that lines are inserted or deleted from the window specified by 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 affected. 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
curses_deleteln(3), curses_insertln(3), curses_scroll(3) 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. BSD
August 12, 2002 BSD
Man Page