*** UNIX MANUAL PAGE BROWSER ***

curs_addstr(3) Library Functions Manual curs_addstr(3) NAME curs_addstr, addstr, addnstr, waddstr, waddnstr, mvaddstr, mvaddnstr, mvwaddstr, mvwaddnstr - Add a string of characters to a Curses window and advance cursor LIBRARY Curses Library (libcurses.a, libcurses.so) SYNOPSIS #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); STANDARDS Interfaces documented on this reference page conform to industry stan- dards as follows: addstr, waddstr, waddnstr, mvaddstr, mvaddnstr, mvwaddstr, mvwaddnstr: XPG4-UNIX Refer to the standards(5) reference page for more information about in- dustry standards and associated tags. DESCRIPTION These routines write the characters of the character string str on the given window. The four routines with n as the last argument write at most n characters. For the other routines, the string should be null- terminated. The effect of these functions is similar to calling waddch once for each character in the string. If n is negative, all routines add the entire string. NOTES The header file curses.h automatically includes the header file stdio.h. Note that all of these routines except waddnstr may be macros. RETURN VALUES All routines return the integer ERR upon failure and OK upon successful completion. RELATED INFORMATION Functions: curses(3), curs_addch(3) Others: standards(5) delim off curs_addstr(3)