- These routines write the characters of the (null-termi-
- nated) wchar_tcharacter 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 construct-
+ ing a cchar_t for each wchar_t in the string, then calling wadd_wch for
+ the resulting cchar_t.
- The mv routines perform cursor movement once, before writ-
- ing any characters. Thereafter, the cursor is advanced as
- a side-effect of writing to the window.
+ 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.
- The four routines with n as the last argument write at
- most nwchar_t 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.
+ 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.
-
-
RETURN VALUES
- All routines return the integer ERR upon failure and OK on
- success.
+
+ 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 waddnwstr 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.
+ o if the corresponding calls to wadd_wch 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.
-