- 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.
+
+ 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.
+
+ 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.
-
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.
+
+ 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 if the window pointer is null
- or if the string pointer is null or if the corresponding
- calls to waddch return an error.
+ mentation returns an error
+
+ o if the window pointer is null or
+
+ o if the string pointer is null or
+
+ 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.
-
NOTES
- Note that all of these routines except waddstr and
- waddnstr may be macros.
+
+ All of these functions except waddnstr may be macros.
-
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.
+