[ Previous | Next | Contents | Glossary | Home | Search ]
AIX Version 4.3 Base Operating System and Extensions Technical Reference, 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

  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);

Implementation Specifics

These subroutines are part of Base Operating System (BOS) Runtime.

Related Information

The insdelln subroutine.

Curses Overview for Programming in AIX Version 4.3 General Programming Concepts: Writing and Debugging Programs.

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

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


[ Previous | Next | Contents | Glossary | Home | Search ]