curs_addstr(3X)                                   curs_addstr(3X)



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

SYNOPSIS
     #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
     All of these routines write all 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 negative, then the entire
     string will be added.

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

NOTES
     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
     curses(3X), curs_addch(3X).
















Page 1                        CX/UX Programmer's Reference Manual