X/Open Curses Library Functions                 addwch(3XCURSES)



NAME
     addwch, mvaddwch, mvwaddwch, waddwch  -  add  a  complex
     character (with   rendition) to a window

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


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


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


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


DESCRIPTION
     The addwch() function writes a  complex  character  to  the
     stdscr   window   at   the  current  cursor  position.   The
     mvaddwch() and mvwaddwch() functions write  the  character
     to  the  position  indicated  by  the x (column) and y (row)
     parameters. The mvaddwch() function writes the character to
     the  stdscr  window, while mvwaddwch() writes the character
     to the window specified  by win.  The waddwch() function is
     identical  to  addwch(),  but  writes the  character to the
     window specified by win.  These functions advance the cursor
     after writing the character.


     If  wch  is  a  spacing  complex  character,  X/Open  Curses
     replaces  any  previous  character at the specified location
     with wch (and its rendition). If wch is a  non-spacing  com-
     plex character, X/Open Curses preserves all existing charac-
     ters at the specified  location  and  adds  the  non-spacing
     characters  of  wch  to  the  spacing  complex character. It
     ignores the  rendition associated with wch.


     Characters that do not fit on the end of  the  current  line
     are  wrapped  to  the  beginning of the next line unless the
     current line is the last line of the window and scrolling is
     disabled.  In that situation, X/Open Curses discards charac-
     ters which extend beyond the end  of the line.




SunOS 5.11           Last change: 5 Jun 2002                    1






X/Open Curses Library Functions                 addwch(3XCURSES)



     When wch is a backspace, carriage return, newline,  or  tab,
     X/Open Curses moves the cursor appropriately as described in
     the curses(3XCURSES) man page. Each tab character moves  the
     cursor  to  the  next  tab stop. By default, tab stops occur
     every eight columns. When wch is a control  character  other
     than  a  backspace,  carriage return, newline, or tab, it is
     written using ^x notation, where x is a printable character.
     When X/Open Curses writes wch to the last character position
     on a line, it automatically generates a newline.  When   wch
     is  written  to  the  last character position of a scrolling
     region and scrollok() is enabled, X/Open Curses scrolls  the
     scrolling region up one line (see clearok(3XCURSES)).

PARAMETERS
     wch    Is the character/attribute  pair  (rendition)  to  be
            written to the window.


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


     y      Is the y (row) coordinate of the character's position
            in the window.


     x      Is the x (column) coordinate of the character's posi-
            tion in the window.


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                 addwch(3XCURSES)



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Standard                    
    
     MT-Level                     Unsafe                      
    


SEE ALSO
     attroff(3XCURSES),  bkgrndset(3XCURSES),  curses(3XCURSES),
     doupdate(3XCURSES),   inwch(3XCURSES),   inswch(3XCURSES),
     libcurses(3XCURSES),     nl(3XCURSES),     printw(3XCURSES),
     scrollok(3XCURSES),   scrl(3XCURSES),   setscrreg(3XCURSES),
     terminfo(4), attributes(5), standards(5)








































SunOS 5.11           Last change: 5 Jun 2002                    3