HP 3000 Manuals

MPE/iX Developer's Kit Reference Manual Volume II

insch, winsch, mvinsch, mvwinsch 

The insch set of routines is used to insert a character.

Syntax 

     #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);

Parameters 

ch                    The character to be inserted.

win                   A pointer to the window in which the character is
                      to be inserted.

x                     The x (column) coordinate of the position of the
                      character.

y                     The y (row) coordinate of the position of the
                      character.

Return Values 

OK                    Successful completion.

ERR                   An error occurred.

Description 

The insch() routine inserts the chtype character at the current cursor
position of the stdscr window.  The winsch() routine performs the
identical action but in window win.  The mvinsch() and mvwinsch()
routines insert the character at the position indicated by the x (column)
and y (row) parameters (the former in the stdscr window; the latter in
window win).  The cursor position does not change.

All characters to the right of the inserted character are moved right one
character.  The last character on the line is deleted.


NOTE  All routines except winsch() are macros.


Implementation Considerations 

Identical to XPG/3

See Also 

delch(), insstr()

Portability 

HP-UX, UNIX System V, XPG/3

MPE/iX 5.0 Documentation