insertln or winsertln Subroutine

Purpose

Inserts a blank line above the current line in a window.

Library

Curses Library (libcurses.a)

Syntax

#include <curses.h>
int insertln(void)

int winsertln(WINDOW  *win);

Description

The insertln and winsertln subroutines insert a blank line before the current line in the current or specified window. The bottom line is no longer displayed. The cursor position does not change.

Parameters

Item Description
*win Specifies the window in which to insert the blank line.

Return Values

Upon successful completion, these subroutines return OK. Otherwise, they return ERR.

Examples

  1. To insert a blank line above the current line in the stdscr, enter:
    insertln();
  2. To insert a blank line above the current line in the user-defined window my_window, enter:
    WINDOW *mywindow;
    winsertln(my_window);