X-Git-Url: http://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_addchstr.3x.html;h=1b193b7ebf5a9e20dd337750d9e3ac593f93486f;hp=e8861399946af891b70e87cad3938634b4fcf347;hb=e2d7d0028f4298dca2b0edaf2dc8ce30518d9218;hpb=448c4dbefe6aa9604a5a8cefa3b3596b3ddb4b78
diff --git a/doc/html/man/curs_addchstr.3x.html b/doc/html/man/curs_addchstr.3x.html
index e8861399..1b193b7e 100644
--- a/doc/html/man/curs_addchstr.3x.html
+++ b/doc/html/man/curs_addchstr.3x.html
@@ -1,7 +1,7 @@
@@ -62,62 +62,63 @@
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
- *chstr);
- int mvwaddchnstr(WINDOW *win, int y, int x, const chtype
- *chstr, int n);
+ int mvwaddchstr(WINDOW *win, int y, int x, const chtype *chstr);
+ int mvwaddchnstr(WINDOW *win, int y, int x, const chtype *chstr, int n);
DESCRIPTION
- 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-
- 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,
- 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 than wrap-
- ping it around to the new line.
+ These functions copy the (null-terminated) chstr array in-
+ to the window image structure starting at the current cur-
+ sor position. The four functions with n as the last argu-
+ ment copy at most n elements, but no more than will fit on
+ the line. If n=-1 then the whole array is copied, to the
+ maximum number of characters that will fit on the line.
+
+ The window cursor is not advanced. These functions work
+ faster than waddnstr. On the other hand:
+
+ o they do not perform checking (such as for the newline,
+ backspace, or carriage return characters),
+
+ o they do not advance the current cursor position,
+
+ o they do not expand other control characters to ^-es-
+ capes, and
+
+ o they truncate the string if it crosses the right mar-
+ gin, rather than wrapping it around to the new line.
-RETURN VALUES
- 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, unless other-
- wise noted in the preceding routine descriptions.
+RETURN VALUE
+ All functions return the integer ERR upon failure and OK
+ on success.
- X/Open does not define any error conditions. This imple-
+ 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
+ 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.
NOTES
- Note that all routines except waddchnstr may be macros.
+ All functions except waddchnstr may be macros.
PORTABILITY
- These entry points are described in the XSI Curses stan-
+ These entry points are described in the XSI Curses stan-
dard, Issue 4.
SEE ALSO
- curses(3x).
+ curs_addstr(3x), curses(3x).
- Comparable functions in the wide-character (ncursesw) li-
+ Comparable functions in the wide-character (ncursesw) li-
brary are described in curs_add_wchstr(3x).