NAME    [Toc]    [Back]

       addstr,  addnstr,  waddstr, waddnstr, mvaddstr, mvaddnstr,
       mvwaddstr, mvwaddnstr - add a string of  characters  to  a
       curses window and advance cursor

SYNOPSIS    [Toc]    [Back]

       #include <curses.h>

       int addstr(const char *str);
       int addnstr(const char *str, int n);
       int waddstr(WINDOW *win, const char *str);
       int waddnstr(WINDOW *win, const char *str, int n);
       int mvaddstr(int y, int x, const char *str);
       int mvaddnstr(int y, int x, const char *str, int n);
       int mvwaddstr(WINDOW *win, int y, int x, const char *str);
       int mvwaddnstr(WINDOW *win, int y, int x, const char *str,
       int n);

DESCRIPTION    [Toc]    [Back]

       These  routines  write  the characters of the (null-terminated)
 character string str on the given  window.   It  is
       similar  to  calling waddch once for each character in the
       string.  The four routines with n  as  the  last  argument
       write  at  most n characters.  If n is -1, then the entire
       string will be added.

RETURN VALUE    [Toc]    [Back]

       All routines return the integer ERR upon failure and OK on
       success  (the  SVr4 manuals specify only "an integer value
       other than ERR") upon successful completion.

NOTES    [Toc]    [Back]

       Note  that  all  of  these  routines  except  waddstr  and
       waddnstr may be macros.

PORTABILITY    [Toc]    [Back]

       All  these  entry  points  are described in the XSI Curses
       standard, Issue 4.  The XSI errors EILSEQ  and  EOVERFLOW,
       associated  with  extended-level  conformance, are not yet
       detected.

SEE ALSO    [Toc]    [Back]

       curses(3), curs_addch(3).