addnwstr(3X)                                                   addnwstr(3X)

NAME
     addnwstr, addwstr, mvaddnwstr, mvaddwstr, mvwaddnwstr, mvwaddwstr,
     waddnwstr, waddwstr - add a wide-character string to a window and
     advance the cursor

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

     #include <curses.h>

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

     int addwstr(const wchart *wstr);

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

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

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

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

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

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

DESCRIPTION
     These functions write the characters of the wide character string wstr
     on the current or specified window at that window's current or speci-
     fied cursor position.

     These functions advance the cursor position. These functions perform
     special character processing. These functions perform wrapping.

     The effect is similar to building a cchart from the wchart and the
     background rendition and calling waddwch(), once for each wchart
     character in the string. The cursor movement specified by the mv()
     functions occurs only once at the start of the operation.

     The addnwstr(), mvaddnwstr(), mvwaddnwstr() and waddnwstr() functions
     write at most n wide characters. If n is -, then the entire string
     will be added.

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

ERRORS
     No errors are defined.

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



Page 1                       Reliant UNIX 5.44                Printed 11/98