doc/html/man/curs_insch.3x.html

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