Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
curs_insch(3X)							curs_insch(3X)

NAME
       insch,  winsch, mvinsch,	mvwinsch - insert a character before cursor in
       a curses	window

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

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	insertion operation does not change the	cursor
       position.

RETURN VALUE
       All routines that return	an integer return  ERR	upon  failure  and  OK
       (SVr4 specifies only "an	integer	value other than ERR") upon successful
       completion,  unless  otherwise  noted in	the preceding routine descrip-
       tions.

       Functions with a	"mv" prefix first  perform  a  cursor  movement	 using
       wmove, and return an error if the position is outside the window, or if
       the window pointer is null.

NOTES
       These  routines do not necessarily imply	use of a hardware insert char-
       acter feature.

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

PORTABILITY
       These functions are described in	the XSI	Curses standard, Issue 4.

SEE ALSO
       curses(3X).

       Comparable functions in the wide-character (ncursesw) library  are  de-
       scribed in curs_ins_wch(3X).

								curs_insch(3X)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | NOTES | PORTABILITY | SEE ALSO

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=curs_insch&sektion=3&manpath=FreeBSD+14.1-RELEASE+and+Ports>

home | help