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

*win	Specifies the window in which to delete the line.

Return Values

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

Examples

To delete the current line in stdscr, enter:
```
deleteln();
```
To delete the current line in the user-defined window my_window, enter:
```
WINDOW *my_window;
wdeleteln(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.