Technical Reference: Base Operating System and Extensions, Volume 2

delch, mvdelch, mvwdelch or wdelch Subroutine

Purpose

Deletes the character from a window.

Library

Curses Library (libcurses.a)

Syntax

#include <curses.h>

int delch(void);

int mvdelch
(int y
int x);

mvwdelch (WINDOW *win; int y int x);

wdelch
(WINDOW *win);

Description

The delch, mvdelch, mvwdelch, and wdelch subroutines delete the character at the current or specified position in the current or specified window. This subroutine does not change the cursor position.

Parameters

x
y
*win	Identifies the window from which to delete the character.

Return Values

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

Examples

To delete the character at the current cursor location in the standard screen structure, enter:
```
mvdelch();
```
To delete the character at cursor position y=20 and x=30 in the standard screen structure, enter:
```
mvwdelch(20, 30);
```
To delete the character at cursor position y=20 and x=30 in the user-defined window my_window, enter:
```
wdelch(my_window, 20, 30);
```

Related Information

Curses Overview for Programming, List of Curses Subroutines, Manipulating Characters with Curses in AIX 5L Version 5.2 General Programming Concepts: Writing and Debugging Programs.