curs_insch(3X)                                               curs_insch(3X)


   NAME
         cursinsch:  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 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 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).





















   7/91                                                                 Page 1