curs_addstr(3X)						       curs_addstr(3X)

NAME    [Toc]    [Back]

     curs_addstr:  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(char *str);

     int addnstr(char *str, int	n);
     int waddstr(WINDOW	*win, char *str);

     int waddnstr(WINDOW *win, char *str, int n);
     int mvaddstr(y, int x, char *str);

     int mvaddnstr(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    [Toc]    [Back]

     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 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 waddstr and	waddnstr may be
     macros.

SEE ALSO    [Toc]    [Back]

     curses(3X), curs_addch(3X).


									PPPPaaaaggggeeee 1111