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

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

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