- addstr, addnstr, waddstr, waddnstr, mvaddstr, mvaddnstr,
- mvwaddstr, mvwaddnstr - add a string of characters to a
- curses window and advance cursor
+
+ 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-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 char-
+ acters. Thereafter, the cursor is advanced 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 charac-
+ ters, or until a terminating null is reached. If n is -1, then the en-
+ tire string will be added.
- 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.
- 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.
+
+ All functions return the integer ERR upon failure and OK on success.
+ X/Open does not define any error conditions. This implementation re-
+ turns an error
-
-
NOTES
- Note that all of these routines except waddstr and
- waddnstr may be macros.
+ o if the window pointer is null or
+ o if the string pointer is null or
-
-
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 corresponding calls to waddch return an error.
+ Functions with a "mv" prefix first perform a cursor movement using
+ wmove, and return an error if the position is outside the window, or if
+ the window pointer is null.
-