CURS_INSCH(3CURSES) Curses Library Functions CURS_INSCH(3CURSES)
curs_insch, insch, winsch, mvinsch, mvwinsch - insert a character
before the character under the cursor in a curses window
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);
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.)
All routines return the integer ERR upon failure and an integer value
other than ERR upon successful completion.
See attributes(7) for descriptions of the following attributes:
+---------------+-----------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+-----------------+
|MT-Level | Unsafe |
+---------------+-----------------+
curses(3CURSES), attributes(7)
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)
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)