Curses Library Functions                     cursinsstr(3CURSES)



NAME
     cursinsstr, insstr, insnstr, winsstr,  winsnstr,  mvinsstr,
     mvinsnstr,  mvwinsstr,  mvwinsnstr  -  insert  string before
     character under the cursor in a curses window

SYNOPSIS
     cc [ flag ... ] file ... -lcurses [ library ... ]
     #include 

     int insstr(char *str);


     int insnstr(char *str, int n);


     int winsstr(WINDOW *win, char *str);


     int winsnstr(WINDOW *win, char *str, int n);


     int mvinsstr(int y, int x, char *str);


     int mvinsnstr(int y, int x, char *str, int n);


     int mvwinsstr(WINDOW *win, int y, int x, char *str);


     int mvwinsnstr(WINDOW *win, int y, int x, char *str, int n);


DESCRIPTION
     With these routines, a character string (as many  characters
     as  will  fit  on the line) is inserted before the character
     under the cursor. All characters to the right of the  cursor
     are  moved  to the right, with the possibility of the right-
     most 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  entire
     string is inserted.


     If a character in str is a tab, newline, carriage return  or
     backspace, the cursor is moved appropriately within the win-
     dow. A newline also does a 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



SunOS 5.11          Last change: 31 Dec 1996                    1






Curses Library Functions                     cursinsstr(3CURSES)



     (and moving to it, if necessary) does not return the control
     character,  but  instead  returns  the representation of the
     control character.

RETURN VALUES
     All routines return the integer  ER  upon  failure  and  an
     integer value other than ER upon successful completion.

ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     MT-Level                     Unsafe                      
    


SEE ALSO
     cursclear(3CURSES),  cursinch(3CURSES),   curses(3CURSES),
     attributes(5)

NOTES
     The header   automatically  includes  the  headers
      and .


     Note that all but winsnstr() may be macros.
























SunOS 5.11          Last change: 31 Dec 1996                    2