Curses Library Functions                     cursaddstr(3CURSES)



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

SYNOPSIS
     cc [ flag ... ] file ... -lcurses [ library ... ]
     #include 

     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. 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 VALUES
     All routines return the integer  ER  upon  failure  and  an
     integer value other than ER upon successful completion.

ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:







SunOS 5.11          Last change: 31 Dec 1996                    1






Curses Library Functions                     cursaddstr(3CURSES)



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     MT-Level                     Unsafe                      
    


SEE ALSO
     cursaddch(3CURSES), curses(3CURSES), attributes(5)

NOTES
     The header   automatically  includes  the  headers
      and .


     Note that all routines except waddstr() and  waddnstr()  may
     not be macros.






































SunOS 5.11          Last change: 31 Dec 1996                    2