NAME    [Toc]    [Back]

       curs_insstr, insstr, insnstr, winsstr, winsnstr, mvinsstr,
       mvinsnstr, mvwinsstr, mvwinsnstr - Insert a string  before
       the character under the cursor in a Curses window

SYNOPSIS    [Toc]    [Back]

       #include <curses.h>

       int insstr(
               const char *str ); int insnstr(
               const char *str,
               int n ); int winsstr(
               WINDOW *win,
               const char *str ); int winsnstr(
               WINDOW *win,
               const char *str,
               int n ); int mvinsstr(
               int y,
               int x,
               const char *str ); int mvinsnstr(
               int y,
               int x,
               const char *str,
               int n ); int mvwinsstr(
               WINDOW *win,
               int y,
               int x,
               const char *str ); int mvwinsnstr(
               WINDOW *win,
               int y,
               int x,
               const char *str,
               int n );

LIBRARY    [Toc]    [Back]

       Curses Library (libcurses)

STANDARDS    [Toc]    [Back]

       Interfaces  documented  on  this reference page conform to
       industry standards as follows:

       insstr, insnstr, winsstr, winsnstr,  mvinsstr,  mvinsnstr,
       mvwinsstr, mvwinsnstr:  XCURSES4.2

       Refer to the standards(5) reference page for more information
 about industry standards and associated tags.

DESCRIPTION    [Toc]    [Back]

       These routines insert a character string (as many  characters
  as  will fit on the line) before the character under
       the cursor. All characters to the right of the cursor  are
       moved  to the right, with the possibility of the rightmost
       characters 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.


       The  four  routines  with n as the last argument insert at
       most n characters. If n<=0, then the routines  insert  the
       entire string.

       If  a character in str is a tab, newline, carriage return,
       or backspace, the routines move the  cursor  appropriately
       within  the  window. A newline also causes clrtoeol before
       moving. Tabs are considered to be at every eighth  column.
       If  a character in str is another control character, it is
       drawn in the ^X notation. Calling  winch  after  adding  a
       control  character  (and  moving to it, if necessary) does
       not return the control character, but instead returns  the
       representation of the control character.

NOTES    [Toc]    [Back]

       The  header  file  <curses.h>  automatically  includes the
       header file <stdio.h>.

       Note that all but winsnstr may be macros.

RETURN VALUES    [Toc]    [Back]

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

SEE ALSO    [Toc]    [Back]

       Functions: curses(3), curs_clear(3), curs_inch(3)

       Others: standards(5)



                                                   curs_insstr(3)