X/Open Curses Library Functions               insnwstr(3XCURSES)



NAME
     insnwstr, inswstr, mvinsnwstr, mvinswstr,  mvwinsnwstr,
     mvwinswstr, winsnwstr, winswstr - insert a wide character
     string

SYNOPSIS
     cc [ flag... ] file... -I /usr/xpg4/include  -L  /usr/xpg4/lib \
      -R  /usr/xpg4/lib  -lcurses  [ library... ]

     c89 [ flag... ] file... -lcurses [ library... ]

     #include 

     int insnwstr(const wchart *wstr, int n);


     int inswstr(const wchart *wstr);


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


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


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


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


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


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


PARAMETERS
     wstr    Is a pointer to the string to be inserted.


     n       Is the number  of  characters  not  to  exceed  when
             inserting  wstr.    If  n is less than 1, the entire
             string is inserted.


     y       Is the y (row) coordinate of the  starting  position
             of the string.


     x       Is the x (column) coordinate of the  starting  posi-
             tion of the string.



SunOS 5.11           Last change: 5 Jun 2002                    1






X/Open Curses Library Functions               insnwstr(3XCURSES)



     win     Is a pointer to the window in which the string is to
             be inserted.


DESCRIPTION
     The inswstr() function inserts wstr at the  current  cursor
     position of the stdscr window. The winswstr() function per-
     forms  the  identical  action,  but  in  window   win.   The
     mvinswstr()  and mvwinswstr() functions insert wstr string
     at the starting position indicated by the x (column)  and  y
     (row)  parameters  (the  former  in  the  stdscr window; the
     latter in window win).


     The   insnwstr(),    winsnwstr(),    mvinsnwstr(),    and
     mvwinsnwstr()  functions  insert n characters to the window
     or as  many as will fit on the line. If n is  less  than  1,
     the  entire  string is inserted or as much of it as  fits on
     the line.  The former two functions place the string at  the
     current  cursor  position;  the  latter two commands use the
     position specified by the x and y parameters.


     All characters to the right of inserted characters are moved
     to the right.  Characters that don't fit on the current line
     are discarded. The cursor is left at the point of insertion.


     If a character in wstr is a newline, carriage return,  back-
     space, or tab,  the cursor is moved appropriately.  The cur-
     sor is moved to the next tab stop for each tab character (by
     default,  tabs are eight characters apart). If the character
     is a control character  other  than  those  previously  men-
     tioned, the character is inserted using ^x notation, where x
     is a printable character.  clrtoeol(3XCURSES)  is  automati-
     cally done before a newline.

RETURN VALUES
     On success, these functions  return  OK.    Otherwise,  they
     return ER.

ERORS
     None.

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








SunOS 5.11           Last change: 5 Jun 2002                    2






X/Open Curses Library Functions               insnwstr(3XCURSES)



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Standard                    
    
     MT-Level                     Unsafe                      
    


SEE ALSO
     addwchnstr(3XCURSES),                   addnwstr(3XCURSES),
     clrtoeol(3XCURSES),   inswch(3XCURSES),  insnstr(3XCURSES),
     libcurses(3XCURSES), attributes(5), standards(5)










































SunOS 5.11           Last change: 5 Jun 2002                    3