https://invisible-island.net/ncurses/man/

curs_delch 3x 2024-09-21 ncurses 6.5 Library calls

curs_delch(3x)                   Library calls                  curs_delch(3x)

NAME

       delch,  wdelch,  mvdelch,  mvwdelch  - delete a character from a curses
       window

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(3x) (wide-
       character API users: bkgrnd(3x)).  The cursor position does not  change
       (after  moving  to  (y,  x),  if specified).  ncurses(3x) describes 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
       employed.

PORTABILITY

       X/Open Curses, Issue 4 describes  these  functions.   It  specifies  no
       error conditions for them.

       SVr4  curses  describes  a  successful return value only as "an integer
       value other than ERR".

HISTORY

       SVr2 (1984) introduced delch.