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)