add_wch(3X)                                                     add_wch(3X)

NAME
     addwch, mvaddwch, mvwaddwch, waddwch - add a complex character and
     rendition to a window

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

     #include <curses.h>

     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
     These functions add information to the current or specified window at
     the current or specified position, and then advance the cursor. These
     functions perform wrapping. These functions perform special-character
     processing.

     -  If wch refers to a spacing character, then any previous character
        at that location is removed, a new character specified by wch is
        placed at that location with rendition specified by wch; then the
        cursor advances to the next spacing character on the screen.

     -  If wch refers to a non-spacing character, all previous characters
        at that location are preserved, the non-spacing characters of wch
        are added to the spacing complex character, and the rendition
        specified by wch is ignored.

RETURN VALUE
     Upon successful completion, these functions return OK. Otherwise, they
     return ERR.

ERRORS
     No errors are defined.

SEE ALSO
     addch(3X), curses(3X), curses(5).













Page 1                       Reliant UNIX 5.44                Printed 11/98