curs_addwstr(3X)					      curs_addwstr(3X)

NAME    [Toc]    [Back]

     curs_addwstr: addwstr, addnwstr, waddwstr,	waddnwstr, mvaddwstr,
     mvaddnwstr, mvwaddwstr, mvwaddnwstr - add a string	of wchar_t characters
     to	a curses window	and advance cursor

SYNOPSIS    [Toc]    [Back]

     #include <curses.h>

     int addwstr(wchar_t *wstr);

     int addnwstr(wchar_t *wstr, int n);
     int waddwstr(WINDOW *win, wchar_t *wstr);

     int waddnwstr(WINDOW *win,	wchar_t	*wstr, int n);
     int mvaddwstr(y, int x, wchar_t *wstr);

     int mvaddnwstr(y, int x, wchar_t *wstr, int n);
     int mvwaddwstr(WINDOW *win, int y,	int x, wchar_t *wstr);

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

DESCRIPTION    [Toc]    [Back]

     All of these routines write all the characters of the null-terminated
     wchar_t character string str on the given window.	The effect is similar
     to	calling	waddwch	once for each wchar_t character	in the string.	The
     four routines with	n as the last argument write at	most n <b>wchar_t
     characters.  If n is negative, then the entire string will	be added.

RETURN VALUE    [Toc]    [Back]

     All routines return the integer ERR upon failure and an integer value
     other than	ERR upon successful completion.

NOTES    [Toc]    [Back]

     The header	file <curses.h>	automatically includes the header files
     <stdio.h> and <unctrl.h>.

     Note that all of these routines except waddwstr and waddnwstr may be
     macros.

SEE ALSO    [Toc]    [Back]

     curses(3X), curs_addwch(3X).


									PPPPaaaaggggeeee 1111