add_wchnstr(3X)                                             add_wchnstr(3X)

NAME
     addwchnstr, addwchstr, mvaddwchnstr, mvaddwchstr, mvwaddwchnstr,
     mvwaddwchstr, waddwchnstr, waddwchstr - add an array of complex
     characters and renditions to a window

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

     #include <curses.h>

     int addwchnstr(const cchart *wchstr, int n);

     int addwchstr(const cchart *wchstr);

     int waddwchnstr(WINDOW *win, const cchart *wchstr, int n);

     int waddwchstr(WINDOW *win, const cchart *wchstr);

     int mvaddwchnstr(int y, int x, const cchart *wchstr, int n);

     int mvaddwchstr(int y, int x, const cchart *wchstr);

     int mvwaddwchnstr(WINDOW *win, int y, int x, const cchart *wchstr,
               int n);

     int mvwaddwchstr(WINDOW *win, int y, int x, const cchart *wchstr);

DESCRIPTION
     These functions write the array of cchart specified by wchstr into
     the current or specified window starting at the current or specified
     cursor position.

     These functions do not advance the cursor. The results are unspecified
     if wchstr contains any special characters.

     The functions end successfully on encountering a null cchart. The
     functions also end successfully when they fill the current line. If a
     character cannot completely fit at the end of the current line, those
     columns are filled with the background character and rendition.

     The addwchnstr(), mvaddwchnstr(), mvwaddwchnstr() and
     waddwchnstr() functions end successfully after writing n ccharts (or
     the entire array of ccharts, if n is -).

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

ERRORS
     No errors are defined.





Page 1                       Reliant UNIX 5.44                Printed 11/98

add_wchnstr(3X)                                             add_wchnstr(3X)

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




















































Page 2                       Reliant UNIX 5.44                Printed 11/98