Index Click this button to go to the index for this section.


curs_insch(3)

NAME

curs_insch, insch, winsch, mvinsch, mvwinsch - Insert a character before the character under the cursor in a Curses window

LIBRARY

Curses Library (libcurses.a, libcurses.so)

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

STANDARDS

Interfaces documented on this reference page conform to industry standards as follows: insch, winsch, mvinsch, mvwinsch: XPG4, XPG4-UNIX Refer to the standards(5) reference page for more information about industry standards and associated tags.

DESCRIPTION

These routines insert the character ch 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.)

NOTES

The header file curses.h automatically includes the header file stdio.h. Note that insch, mvinsch, and mvwinsch may be macros.

RETURN VALUES

All routines return the integer ERR upon failure and OK upon successful completion.

RELATED INFORMATION

Functions: curses(3) Others: standards(5)