Technical Reference: Base Operating System and Extensions , Volume 2

deleteln or wdeleteln Subroutine

Purpose

Deletes lines in a window.

Library

Curses Library (libcurses.a)

Syntax

#include <curses.h>

int deleteln(void);

int wdeleteln(WINDOW *win);

Description

The deleteln and wdeleteln subroutines delete the line containing the cursor in the current or specified window and move all lines following the current line one line toward the cursor. The last line of the window is cleared. The cursor position does not change.

Parameters

Return Values

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

Examples

1. To delete the current line in stdscr, enter:

   deleteln();
   

2. To delete the current line in the user-defined window my_window, enter:

   WINDOW *my_window;
   wdeleteln(my_window);
   

Implementation Specifics

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

Related Information

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

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

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