linux man page for curs_insch

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(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE         |      ATTRIBUTE VALUE        |
       +-----------------------------+-----------------------------+
       |MT-Level                     |Unsafe                       |
       +-----------------------------+-----------------------------+

SEE ALSO
       curses(3CURSES), attributes(5)

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

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

SunOS 5.10                                                          31 Dec 1996                                                curs_insch(3CURSES)