Ada95/html/curs_insch.3x.html

   1 <HTML>
   2 <BODY BGCOLOR="#99ccbb" TEXT="#000000" LINK="#4060b0" VLINK="#000080" ALINK="#ff4040">
   3 <PRE>
   4        <STRONG>insch</STRONG>,  <STRONG>winsch</STRONG>,  <STRONG>mvinsch</STRONG>,  <STRONG>mvwinsch</STRONG>  -  insert a character
   5        before cursor in a <STRONG>curses</STRONG> window
   6
   7
   8 </PRE>
   9 <H2>SYNOPSIS</H2><PRE>
  10        <STRONG>#include</STRONG> <STRONG>&lt;curses.h&gt;</STRONG>
  11
  12        <STRONG>int</STRONG> <STRONG>insch(chtype</STRONG> <STRONG>ch);</STRONG>
  13        <STRONG>int</STRONG> <STRONG>winsch(WINDOW</STRONG> <STRONG>*win,</STRONG> <STRONG>chtype</STRONG> <STRONG>ch);</STRONG>
  14        <STRONG>int</STRONG> <STRONG>mvinsch(int</STRONG> <STRONG>y,</STRONG> <STRONG>int</STRONG> <STRONG>x,</STRONG> <STRONG>chtype</STRONG> <STRONG>ch);</STRONG>
  15        <STRONG>int</STRONG> <STRONG>mvwinsch(WINDOW</STRONG> <STRONG>*win,</STRONG> <STRONG>int</STRONG> <STRONG>y,</STRONG> <STRONG>int</STRONG> <STRONG>x,</STRONG> <STRONG>chtype</STRONG> <STRONG>ch);</STRONG>
  16
  17
  18 </PRE>
  19 <H2>DESCRIPTION</H2><PRE>
  20        These routines, insert the character <EM>ch</EM> before the charac-
  21        ter  under the cursor.  All characters to the right of the
  22        cursor are moved one space to the right, with  the  possi-
  23        bility  of the rightmost character on the line being lost.
  24        The insertion operation does not change the  cursor  posi-
  25        tion.
  26
  27
  28 </PRE>
  29 <H2>RETURN VALUE</H2><PRE>
  30        All  routines that return an integer return <STRONG>ERR</STRONG> upon fail-
  31        ure and OK (SVr4 specifies only "an  integer  value  other
  32        than  <STRONG>ERR</STRONG>")  upon  successful completion, unless otherwise
  33        noted in the preceding routine descriptions.
  34
  35
  36 </PRE>
  37 <H2>NOTES</H2><PRE>
  38        These routines do not necessarily imply use of a  hardware
  39        insert character feature.
  40
  41        Note that <STRONG>insch</STRONG>, <STRONG>mvinsch</STRONG>, and <STRONG>mvwinsch</STRONG> may be macros.
  42
  43
  44 </PRE>
  45 <H2>PORTABILITY</H2><PRE>
  46        These  functions are described in the XSI Curses standard,
  47        Issue 4.
  48
  49
  50 </PRE>
  51 <H2>SEE ALSO</H2><PRE>
  52        <STRONG><A HREF="ncurses.3x.html">curses(3X)</A></STRONG>.
  53
  54
  55
  56
  57
  58
  59
  60
  61
  62
  63
  64
  65
  66
  67
  68 </PRE>
  69 </BODY>
  70 </HTML>