CURS_INSCH(3CURSES) Curses Library Functions CURS_INSCH(3CURSES)
NAME
curs_insch, insch, winsch, mvinsch, mvwinsch - insert a character
before the character under the cursor in a curses window
SYNOPSIS
cc [
flag ... ]
file...
-lcurses [
library ... ]
#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
With these routines, the character
ch is inserted before the
character under the cursor. All characters to the right of the cursor
are moved one space to the right, with the possibility of the
rightmost character on the line being lost. The cursor position does
not change (after moving to
y,
x, if specified). (This does not imply
use of the hardware insert character feature.)
RETURN VALUES
All routines return the integer
ERR upon failure and an integer value
other than
ERR upon successful completion.
ATTRIBUTES
See
attributes(7) for descriptions of the following attributes:
+---------------+-----------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+-----------------+
|MT-Level | Unsafe |
+---------------+-----------------+
SEE ALSO
curses(3CURSES),
attributes(7)NOTES
The header <
curses.h> automatically includes the headers <
stdio.h>
and <
unctrl.h>.
Note that
insch(),
mvinsch(), and
mvwinsch() may be macros.
December 31, 1996 CURS_INSCH(3CURSES)