Technical Reference: Base Operating System and Extensions, Volume 2

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

*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

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

Related Information

Curses Overview for Programming in AIX 5L Version 5.2 General Programming Concepts: Writing and Debugging Programs.

List of Curses Subroutines in AIX 5L Version 5.2 General Programming Concepts: Writing and Debugging Programs.

Manipulating Characters with Curses in AIX 5L Version 5.2 General Programming Concepts: Writing and Debugging Programs.