X-Git-Url: https://ncurses.scripts.mit.edu/?a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_addstr.3x.html;h=ccc93a3e79d4a8ee954b3771289f59727b69d465;hb=refs%2Ftags%2Fv5.5;hp=e83e795f01fd65db5191e3dc3b944fca0bd6866d;hpb=b1f61d9f3aa244512045a6b02e759825d7049d34;p=ncurses.git diff --git a/doc/html/man/curs_addstr.3x.html b/doc/html/man/curs_addstr.3x.html index e83e795f..ccc93a3e 100644 --- a/doc/html/man/curs_addstr.3x.html +++ b/doc/html/man/curs_addstr.3x.html @@ -1,75 +1,116 @@ + + +
++curs_addstr(3x) curs_addstr(3x) + + +
- addstr, addnstr, waddstr, waddnstr, mvaddstr, mvaddnstr, - mvwaddstr, mvwaddnstr - add a string of characters to a - curses window and advance cursor + addstr, addnstr, waddstr, waddnstr, mvaddstr, mvaddnstr, + mvwaddstr, mvwaddnstr - add a string of characters to a + curses window and advance cursor
- #include <curses.h> + #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); + 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);
- These routines write the characters of the (null-termi- - nated) 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 -1, then the entire - string will be added. + These routines write the characters of the (null-terminat- + ed) character string str on the given window. It is simi- + lar 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 -1, then the entire + string will be added, up to the maximum number of charac- + ters that will fit on the line, or until a terminating + null is reached.
- All routines return the integer ERR upon failure and OK on + All routines return the integer ERR upon failure and OK on success (the SVr4 manuals specify only "an integer value - other than ERR") upon successful completion. + other than ERR") upon successful completion. + + X/Open does not define any error conditions. This imple- + mentation returns an error if the window pointer is null + or if the string pointer is null or if the corresponding + calls to waddch return an error.
- Note that all of these routines except waddstr and - waddnstr may be macros. + Note that all of these routines except waddstr and + waddnstr may be macros.
- All these entry points are described in the XSI Curses - standard, Issue 4. The XSI errors EILSEQ and EOVERFLOW, - associated with extended-level conformance, are not yet + All these entry points are described in the XSI Curses + standard, Issue 4. The XSI errors EILSEQ and EOVERFLOW, + associated with extended-level conformance, are not yet detected.
- curses(3x), curs_addch(3x). - - - - - - - - + curses(3x), curs_addch(3x). + curs_addstr(3x)