X/Open Curses Library Functions                 inswch(3XCURSES)



NAME
     inswch, winswch, mvinswch, mvwinswch - insert a  complex
     character

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 inswch(const cchart *wch);


     int mvinswch(int y, int x, const cchart *wch);


     int mvwinswch(WINDOW *win, int y, int x, const cchart *wch);


     int winswch(WINDOW *win, const cchart *wch);


PARAMETERS
     wch    Is the complex character to be inserted.


     y      Is the y (row) coordinate  of  the  position  of  the
            character.


     x      Is the x (column) coordinate of the position  of  the
            character.


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


DESCRIPTION
     The inswch() function inserts the complex  character wch at
     the  current  cursor  position  of  the  stdscr  window. The
     winswch() function performs the  identical  action  but  in
     window  win.   The  mvinswch()  and  mvwinswch() functions
     insert the character at the  position  indicated  by  the  x
     (column)  and  y (row) parameters  (the former in the stdscr
     window; the latter in window win).  The cursor position does
     not change.






SunOS 5.11           Last change: 5 Jun 2002                    1






X/Open Curses Library Functions                 inswch(3XCURSES)



     All characters to the right of the  inserted  character  are
     moved  right one  character.  The last character on the line
     is deleted.


     Insertions and deletions occur at the character  level.  The
     cursor  is  adjusted  to  the  first column of the character
     prior to the operation.

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:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Standard                    
    
     MT-Level                     Unsafe                      
    


SEE ALSO
     addwch(3XCURSES), insnwstr(3XCURSES), libcurses(3XCURSES),
     attributes(5), standards(5)





















SunOS 5.11           Last change: 5 Jun 2002                    2