# curs_addwstr 3x

    curs_addwstr(3x)                                       curs_addwstr(3x)

## NAME

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

## SYNOPSIS

           #include <curses.h>

           int addwstr(const wchar_t *wstr);
           int addnwstr(const wchar_t *wstr, int n);
           int waddwstr(WINDOW *win, const wchar_t *wstr);
           int waddnwstr(WINDOW *win, const wchar_t *wstr, int n);
           int mvaddwstr(int y, int x, const wchar_t *wstr);
           int mvaddnwstr(int y, int x, const wchar_t *wstr, int n);
           int mvwaddwstr(WINDOW *win, int y, int x, const wchar_t *wstr);
           int mvwaddnwstr(WINDOW *win, int y, int x, const wchar_t *wstr, int n);

## DESCRIPTION

           These routines write the characters of the (null-terminat-
           ed) wchar_t character string wstr on the given window.  It
           is  similar  to constructing a cchar_t for each wchar_t in
           the  string,  then  calling  wadd_wch  for  the  resulting
           cchar_t.

           The mv routines perform cursor movement once, before writ-
           ing any characters.  Thereafter, the cursor is advanced as
           a side-effect of writing to the window.

           The  four  routines  with  n as the last argument write at
           most n wchar_t characters.  If n is -1,  then  the  entire
           string  will be added, up to the maximum number of charac-
           ters that will fit on the line,  or  until  a  terminating
           null is reached.

## RETURN VALUES

           All routines return the integer ERR upon failure and OK on
           success.

           Functions with a "mv" prefix first perform a cursor  move-
           ment  using  wmove, and return an error if the position is
           outside the window, or if the window pointer is null.

## NOTES

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

## PORTABILITY

           All  these  entry  points  are described in the XSI Curses
           standard, Issue 4.

## SEE ALSO

           curses(3x), curs_add_wch(3x)

                                                           curs_addwstr(3x)