+ addstr, addnstr, waddstr, waddnstr, mvaddstr, mvaddnstr,
+ mvwaddstr, mvwaddnstr - add a string of characters to a
curses window and advance cursor
-
- 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, up to the maximum number of charac-
- ters that will fit on the line, or until a terminating
- null is reached.
+
+ These functions write the (null-terminated) character
+ string str on the given window. It is similar to calling
+ waddch once for each character in the string.
+ The mv functions perform cursor movement once, before
+ writing any characters. Thereafter, the cursor is ad-
+ vanced as a side-effect of writing to the window.
-
-
RETURN VALUE
- 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.
+ The four functions with n as the last argument write at
+ most n characters, or until a terminating null is reached.
+ If n is -1, then the entire string will be added.
-
-
NOTES
- Note that all of these routines except waddstr and
- waddnstr may be macros.
+
+ All functions return the integer ERR upon failure and OK
+ on success.
+ X/Open does not define any error conditions. This imple-
+ mentation returns an error
-
-
PORTABILITY
- 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.
+ o if the window pointer is null or
+ o if the string pointer is null or
-
-
SEE ALSO
+ o if the corresponding calls to waddch return an error.
+
+ 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.
+
+
+