delch(3NCURSES) Library calls delch(3NCURSES)
NAME
delch, wdelch, mvdelch, mvwdelch - delete a character from a curses win-
dow
SYNOPSIS
#include <curses.h>
int delch(void);
int wdelch(WINDOW * win);
int mvdelch(int y, int x);
int mvwdelch(WINDOW * win, int y, int x);
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) de-
scribes the variants of this function.
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.
NOTES
delch, mvdelch, and mvwdelch may be implemented as macros.
A terminal's delete_character (dch1) capability is not necessarily em-
ployed.
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”.
HISTORY
SVr2 (1984) introduced wdelch.
SEE ALSO
ncurses(3NCURSES)
ncurses 6.5 2025-01-18 delch(3NCURSES)
Generated by dwww version 1.16 on Sat Oct 3 03:10:00 CEST 2026.