+ addwstr, addnwstr, waddwstr, waddnwstr, mvaddwstr, mvaddnwstr,
+ mvwaddwstr, mvwaddnwstr - add a wide-character string to a curses
+ window and advance the cursor
-
- These functions write the characters of the (null-termi-
- nated) wchar_t character string wstr on the given window.
- It is similar to constructing a cchar_t for each wchar_t
- in the string, then calling wadd_wch for the resulting
- cchar_t.
+
+ These functions write the characters of the (null-terminated) wchar_t
+ character string wstr on the given window. It is similar to
+ constructing a cchar_t for each wchar_t in the string, then calling
+ wadd_wch(3x) for the resulting cchar_t:
- 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.
+ o spacing and non-spacing characters in the string are processed one
+ at a time, and
- The four functions with n as the last argument write at
- most nwchar_t characters, or until a terminating null is
- reached. If n is -1, then the entire string will be
- added.
+ o control characters are processed as in waddch(3x).
+ The mv functions perform cursor movement once, before writing any
+ characters. Thereafter, the cursor is advanced as a side-effect of
+ writing to the window.
-
-
RETURN VALUE
- All functions return the integer ERR upon failure and OK
- on success.
+ The four functions with n as the last argument write at most nwchar_t
+ characters, or until a terminating null is reached. If n is -1, then
+ the entire string will be added.
+
+
+
+ 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
+ X/Open does not define any error conditions. This implementation
+ 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 wadd_wch return an er-
- ror.
+ o if the corresponding calls to wadd_wch 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.
+ 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.
-