X-Git-Url: http://ncurses.scripts.mit.edu/?a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_addchstr.3x.html;h=e8861399946af891b70e87cad3938634b4fcf347;hb=f367fa254ce3fe29710c86971f04e03111c2bd2c;hp=dae7b70a55a943d3bdec0b1e9fdec021bd043cfc;hpb=55ccd2b959766810cf7db8d1c4462f338ce0afc8;p=ncurses.git diff --git a/doc/html/man/curs_addchstr.3x.html b/doc/html/man/curs_addchstr.3x.html index dae7b70a..e8861399 100644 --- a/doc/html/man/curs_addchstr.3x.html +++ b/doc/html/man/curs_addchstr.3x.html @@ -1,7 +1,7 @@
@@ -62,40 +62,44 @@ int waddchnstr(WINDOW *win, const chtype *chstr, int n); int mvaddchstr(int y, int x, const chtype *chstr); int mvaddchnstr(int y, int x, const chtype *chstr, int n); - int mvwaddchstr(WINDOW *win, int y, int x, const chtype + int mvwaddchstr(WINDOW *win, int y, int x, const chtype *chstr); - int mvwaddchnstr(WINDOW *win, int y, int x, const chtype + int mvwaddchnstr(WINDOW *win, int y, int x, const chtype *chstr, int n);- These routines copy chstr into the window image structure - at and after the current cursor position. The four rou- + These routines copy chstr into the window image structure + at and after the current cursor position. The four rou- tines with n as the last argument copy at most n elements, - but no more than will fit on the line. If n=-1 then the - whole string is copied, to the maximum number of charac- + but no more than will fit on the line. If n=-1 then the + whole string is copied, to the maximum number of charac- ters that will fit on the line. The window cursor is not advanced, and these routines work faster than waddnstr. On the other hand, they do not per- - form any kind of checking (such as for the newline, + form any kind of checking (such as for the newline, backspace, or carriage return characters), they do not ad- vance the current cursor position, they do not expand oth- - er control characters to ^-escapes, and they truncate the - string if it crosses the right margin, rather then wrap- + er control characters to ^-escapes, and they truncate the + string if it crosses the right margin, rather than wrap- ping it around to the new line.
All routines return the integer ERR upon failure and OK on - success (the SVr4 manuals specify only "an integer value + success (the SVr4 manuals specify only "an integer value other than ERR") upon successful completion, unless other- wise noted in the preceding routine descriptions. - X/Open does not define any error conditions. This imple- - mentation returns an error if the window pointer is null. + X/Open does not define any error conditions. This imple- + mentation returns an error if the window pointer is null. + + Functions with a "mv" prefix first perform a cursor move- + ment using wmove, and return an error if the position is + outside the window, or if the window pointer is null.@@ -113,6 +117,9 @@
curses(3x). + Comparable functions in the wide-character (ncursesw) li- + brary are described in curs_add_wchstr(3x). + curs_addchstr(3x)