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

Return Values

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

Examples

1. To delete the character at the current cursor location in the standard screen structure, enter:

   mvdelch();
   

2. To delete the character at cursor position y=20 and x=30 in the standard screen structure, enter:

   mvwdelch(20, 30);
   

3. 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 5L Version 5.1 General Programming Concepts: Writing and Debugging Programs.