curs_insch(3X)                                     curs_insch(3X)



NAME
     curs_insch:  insch, winsch, mvinsch, mvwinsch - insert a
     character before the character under the cursor in a curses
     window

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
     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 possi-
     bility 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 VALUE
     All routines return the integer ERR upon failure and an
     integer value other than ERR upon successful completion.

NOTES
     The header file <curses.h> automatically includes the header
     files <stdio.h> and <unctrl.h>.

     Note that insch, mvinsch, and mvwinsch may be macros.

SEE ALSO
     curses(3X).





















Page 1                        CX/UX Programmer's Reference Manual