delch, wdelch, mvdelch, mvwdelch - delete a character from a curses window
Contents
Description
wdelch deletes the character at the cursor position in win. It moves all characters to the right of the
cursor on the same line to the left one position and replaces the contents of the rightmost position on
the line with the window's background character; see bkgd(3NCURSES) (wide-character API users:
bkgrnd(3NCURSES)). The cursor position does not change (after moving to (y, x), if specified).
ncurses(3NCURSES) describes the variants of this function.
History
SVr2 (1984) introduced wdelch.
Name
delch, wdelch, mvdelch, mvwdelch - delete a character from a curses window
Notes
delch, mvdelch, and mvwdelch may be implemented as macros.
A terminal's delete_character (dch1) capability is not necessarily employed.
Portability
X/Open Curses Issue 4 describes these functions. It specifies no error conditions for them.
SVr4 describes a successful return value only as “an integer value other than ERR”.
Return Value
These functions return OK on success and ERR on failure.
In ncurses, they return ERR if win is NULL.
Functions prefixed with “mv” first perform cursor movement and fail if the position (y, x) is outside the
window boundaries.
See Also
ncurses(3NCURSES) ncurses 6.5 2025-01-18 delch(3NCURSES)
Synopsis
#include<curses.h>intdelch(void);intwdelch(WINDOW*win);intmvdelch(inty,intx);intmvwdelch(WINDOW*win,inty,intx);
