curs_addstr(3curses)                            curs_addstr(3curses)


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

       SYNOPSIS
             cc [flag . . .] file -lcurses [library . . .]
             #include <curses.h>
             int addstr(char *str);
             int addnstr(char *str, int n);
             int waddstr(WINDOW *win, char *str);
             int waddnstr(WINDOW *win, char *str, int n);
             int mvaddstr(int y, int x, char *str);
             int mvaddnstr(int y, int x, char *str, int n);
             int mvwaddstr(WINDOW *win, int y, int x, char *str);
             int mvwaddnstr(WINDOW *win, int y, int x, char *str, int n);

       DESCRIPTION
             All of these routines write all the characters of the null-
             terminated character string str on the given window.  The
             effect 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 negative, then the entire
             string will be added.

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

       REFERENCES
             curses(3curses), curs_addch(3curses)

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

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










                           Copyright 1994 Novell, Inc.               Page 1