X-Git-Url: http://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_addchstr.3x.html;h=e8861399946af891b70e87cad3938634b4fcf347;hp=486f247d61fa233ed7661731d82ec04d56f28c04;hb=9de646fe8f944e760d453b57e01b866d1d514ad7;hpb=a8987e73ec254703634802b4f7ee30d3a485524d
diff --git a/doc/html/man/curs_addchstr.3x.html b/doc/html/man/curs_addchstr.3x.html
index 486f247d..e8861399 100644
--- a/doc/html/man/curs_addchstr.3x.html
+++ b/doc/html/man/curs_addchstr.3x.html
@@ -1,7 +1,7 @@
@@ -40,15 +40,15 @@
-curs_addchstr(3x) curs_addchstr(3x)
+curs_addchstr(3x) curs_addchstr(3x)
NAME
- addchstr, addchnstr, waddchstr, waddchnstr, mvaddchstr,
- mvaddchnstr, mvwaddchstr, mvwaddchnstr - add a string of
+ addchstr, addchnstr, waddchstr, waddchnstr, mvaddchstr,
+ mvaddchnstr, mvwaddchstr, mvwaddchnstr - add a string of
characters (and attributes) to a curses window
@@ -62,38 +62,45 @@
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);
DESCRIPTION
- 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 don't per-
- form any kind of checking (such as for the newline,
- backspace, or carriage return characters), they don't
- advance the current cursor position, they don't expand
- other control characters to ^-escapes, and they truncate
- the string if it crosses the right margin, rather then
- wrapping it around to the new line.
+ 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.
RETURN VALUES
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.
+
+ 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
@@ -102,17 +109,20 @@
PORTABILITY
- All these entry points are described in the XSI Curses
- standard, Issue 4.
+ These entry points are described in the XSI Curses stan-
+ dard, Issue 4.
SEE ALSO
curses(3x).
+ Comparable functions in the wide-character (ncursesw) li-
+ brary are described in curs_add_wchstr(3x).
+
- curs_addchstr(3x)
+ curs_addchstr(3x)