insch, winsch, mvinsch, mvwinsch - insert a curses character in a window
Contents
Description
These functions insert the curses character ch at the cursor in the specified window win (or stdscr).
The character previously at the cursor and any to its right move one cell to the right; the rightmost
character on the line is discarded. The cursor does not advance.
History
SVr2 (1984) introduced winsch.
Name
insch, winsch, mvinsch, mvwinsch - insert a curses character in a window
Notes
insch, mvinsch, and mvwinsch may be implemented as macros.
A terminal's insert_character (ich1) capability is not necessarily employed.
Portability
X/Open Curses Issue 4 describes these functions.
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.
Functions taking a WINDOW pointer argument fail if win is a null pointer.
Functions prefixed with “mv” first perform cursor movement and fail if the position (y, x) is outside the
window boundaries.
See Also
ins_wch(3NCURSES) describes comparable functions in the wide-character curses configuration. ncurses(3NCURSES), terminfo(5) ncurses 6.5 2025-02-01 insch(3NCURSES)
Synopsis
#include<curses.h>intinsch(chtypech);intwinsch(WINDOW*win,chtypech);intmvinsch(inty,intx,chtypech);intmvwinsch(WINDOW*win,inty,intx,chtypech);
