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

Portability

HP-UX, UNIX System V, XPG/3

insch winsch mvinsch mvwinsch

Technical documentation

» Table of Contents

» Index