delch, mvdelch, mvwdelch or wdelch Subroutine

Base Operating System and Extensions Technical Reference, 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);
```

Implementation Specifics

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

Related Information

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