DELCH(3XCURSES) X/Open Curses Library Functions DELCH(3XCURSES)

NAME

delch, mvdelch, mvwdelch, wdelch - remove a character

SYNOPSIS

cc [ flag... ] file... -I /usr/xpg4/include -L /usr/xpg4/lib \
-R /usr/xpg4/lib -lcurses [ library... ]

c89 [ flag... ] file... -lcurses [ library... ]

#include <curses.h>

int delch(void);


int mvdelch(int y, int x);


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


int wdelch(WINDOW *win);

DESCRIPTION

The delch() and wdelch() functions delete the character at the
current cursor position from stdscr and win, respectively. All
remaining characters after cursor through to the end of the line are
shifted one character towards the start of the line. The last
character on the line becomes a space; characters on other lines are
not affected.


The mvdelch() and mvwdelch() functions delete the character at the
position specified by the x and y parameters; the former deletes the
character from stdscr; the latter from win.

PARAMETERS

y
Is the y (row) coordinate of the position of the character to
be removed.


x
Is the x (column) coordinate of the position of the character
to be removed.


win
Is a pointer to the window containing the character to be
removed.

RETURN VALUES

On success, these functions return OK. Otherwise, they return ERR.

ERRORS

None.

ATTRIBUTES

See attributes(7) for descriptions of the following attributes:


+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Standard |
+--------------------+-----------------+
|MT-Level | Unsafe |
+--------------------+-----------------+

SEE ALSO

bkgdset(3XCURSES), insch(3XCURSES), libcurses(3XCURSES),
attributes(7), standards(7)

June 5, 2002 DELCH(3XCURSES)