Curses Library Functions                    cursinswstr(3CURSES)



NAME
     cursinswstr,  inswstr,   insnwstr,   winswstr,   winsnwstr,
     mvinswstr,  mvinsnwstr,  mvwinswstr,  mvwinsnwstr  -  insert
     wchart string before character under the cursor in a curses
     window

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

     int inswstr(wchart *wstr);


     int insnwstr(wchart *wstr, int n);


     int winswstr(WINDOW *win, wchart *wstr);


     int winsnwstr(WINDOW *win, wchart *wstr, int n);


     int mvinswstr(int y, int x, wchart *wstr);


     int mvinsnwstr(int y, int x, wchart *wstr, int n);


     int mvwinswstr(WINDOW *win, int y, int x, wchart *wstr);


     int mvwinsnwstr(WINDOW *win, int y, int x, wchart *wstr, int n);


DESCRIPTION
     These routines insert a  wchart character string  (as  many
     wchart characters as will fit on the line) before the char-
     acter 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 speci-
     fied). (This does not imply use of the hardware insert char-
     acter  feature.)  The four routines with n as the last argu-
     ment insert at most  n wchart characters. If n<=0, then the
     entire string is inserted.


     If a character in  wstr is a tab, newline, carriage  return,
     or  backspace,  the cursor is moved appropriately within the
     window. A newline also does a  clrtoeol(3CURSES) before mov-
     ing.  Tabs are considered to be at every eighth column. If a
     character in  wstr is another control character, it is drawn



SunOS 5.11          Last change: 31 Dec 1996                    1






Curses Library Functions                    cursinswstr(3CURSES)



     in  the  ^X notation. Calling winwch(3CURSES) 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.

RETURN VALUE
     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
     clrtoeol(3CURSES), curses(3CURSES), winwch(3CURSES),  attri-
     butes(5)

NOTES
     The header file  automatically includes the header
     files ,  and .


     Note that all but  winsnwstr() may be macros.























SunOS 5.11          Last change: 31 Dec 1996                    2