NAME

insch, winsch, mvinsch, mvwinsch − insert a character

SYNOPSIS

#include <curses.h>

int insch(chtype ch);

int mvinsch(int y, int x, chtype ch);

int mvwinsch(WINDOW ∗win, int y, int x, chtype ch);

int winsch(WINDOW ∗win, chtype ch);

ARGUMENTS

chIs the character to be inserted. 

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

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

winIs a pointer to the window in which the character is to be inserted. 

DESCRIPTION

The insch() function inserts the chtype character ch at the current cursor position of the stdscr window.  The winsch() function performs the identical action but in window win.  The mvinsch() and mvwinsch() functions 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. 

Insertions and deletions occur at the character level.  The cursor is adjusted to the first column of the character prior to the the operation. 

RETURN VALUES

On success, these functions return OK.  Otherwise, they return ERR. 

ERRORS

None. 

SEE ALSO

delch(3XC), insnstr(3XC)

SunOS 5.6  —  Last change: 1 Jun 1996