- These routines insert a wchar_t character string (as many
- characters as will fit on the line) before the character
- under the cursor. All characters to the right of the cur-
- sor are shifted right, with the possibility of the right-
- most characters on the line being lost. No wrapping is
- performed. The cursor position does not change (after
- moving to y, x, if specified). The four routines with n
- as the last argument insert a leading substring of at most
- nwchar_t characters. If n is less than 1, the entire
- string is inserted.
-
- If a character in wstr is a tab, newline, carriage return
- or backspace, the cursor is moved appropriately within the
- window. A newline also does a clrtoeol before moving.
- Tabs are considered to be at every eighth column. If a
- character in wstr is another control character, it is
- drawn in the ^X notation. Calling win_wch after adding a
- control character (and moving to it, if necessary) does
- not return the control character, but instead returns a
- character in the ^-representation of the control charac-
- ter.
+
+ These routines insert a wchar_t character string (as many characters as
+ will fit on the line) before the character under the cursor, as if
+ calling wins_wch(3x). All characters to the right of the cursor are
+ shifted right, with the possibility of the rightmost characters on the
+ line being lost. No wrapping is performed.
+ The cursor position does not change (after moving to y, x, if
+ specified).
-
-
NOTES
- Note that all but wins_nwstr may be macros.
+ The functions with n as the last argument insert a leading substring of
+ at most nwchar_t characters. If n is less than zero, the entire
+ string is inserted (stopping on a L'\0' character).
- If the first character in the string is a nonspacing char-
- acter, these functions will fail. XSI does not define
- what will happen if a nonspacing character follows a con-
- trol character.
+ Special characters are handled as in wadd_wch(3x).
-
-
RETURN VALUES
- Upon successful completion, these functions return OK.
- Otherwise, they return ERR.
+
+ All functions return the integer ERR upon failure and OK on success.
+ X/Open Curses does not specify any error conditions. This
+ implementation returns an error
-
-
SEE ALSO
- curses(3x), curs_insstr(3x), curs_in_wch(3x),
- curs_ins_wch(3x).
+ o if the win parameter is null or
+
+ o if the wstr parameter is null or
+
+ o if the wins_wch function returns an error.
+
+ Functions prefixed with "mv" first perform cursor movement and fail if
+ the position (y, x) is outside the window boundaries.
+
+
+
+ All but wins_nwstr may be macros.
+
+ If the first character in the string is a non-spacing character, these
+ functions will fail. X/Open Curses does not define what will happen if
+ a non-spacing character follows a control character.
+
+
+
+ These functions are described in X/Open Curses, Issue 4, which adds
+ const qualifiers to the arguments.
+
+ X/Open states that the entire string is inserted if n is less than 1.
+ This is probably an error, because it is inconsistent with other
+ functions, and differs from the X/Open implementation on Solaris.
+
+
+