Manual Page Result
0
Command: curs_insch | Section: 3 | Source: FreeBSD | File: curs_insch.3.gz
curs_insch(3X) Library calls curs_insch(3X)
NAME
insch, winsch, mvinsch, mvwinsch - insert a curses character in a win-
dow
SYNOPSIS
#include <curses.h>
int insch(chtype ch);
int winsch(WINDOW *win, chtype ch);
int mvinsch(int y, int x, chtype ch);
int mvwinsch(WINDOW *win, int y, int x, chtype ch);
DESCRIPTION
These functions insert the curses character ch at the cursor in the
specified window win (or stdscr). The character previously at the cur-
sor and any to its right move one cell to the right; the rightmost
character on the line is discarded. The cursor does not advance.
RETURN VALUE
These functions return OK on success and ERR on failure.
Functions taking a WINDOW pointer argument fail if the pointer is NULL.
Functions prefixed with "mv" first perform cursor movement and fail if
the position (y, x) is outside the window boundaries.
NOTES
insch, mvinsch, and mvwinsch may be implemented as macros.
A terminal's insert_character (ich1) capability is not necessarily em-
ployed.
PORTABILITY
X/Open Curses, Issue 4 describes these functions.
SVr4 curses describes a successful return value only as "an integer
value other than ERR".
SEE ALSO
curs_ins_wch(3X) describes comparable functions in the wide-character
curses configuration.
curses(3X), terminfo(5)
ncurses 6.5 2024-04-20 curs_insch(3X)