- These functions copy the (null-terminated) array of com-
- plex characters wchstr into the window image structure
- starting at the current cursor position. The four func-
- tions with n as the last argument copy at most n elements,
- but no more than will fit on the line. If n=-1 then the
- whole array is copied, to the maximum number of characters
- that will fit on the line.
+
+ These functions copy the (null-terminated) array of complex characters
+ wchstr into the window image structure starting at the current cursor
+ position. The four functions with n as the last argument copy at most
+ n elements, but no more than will fit on the line. If n=-1 then the
+ whole array is copied, to the maximum number of characters that will
+ fit on the line.
- The window cursor is not advanced. These functions work
- faster than waddnstr. On the other hand:
+ The window cursor is not advanced. These functions work faster than
+ waddnstr. On the other hand:
- o they do not perform checking (such as for the newline,
- backspace, or carriage return characters),
+ o they do not perform checking (such as for the newline, backspace,
+ or carriage return characters),
o they do not advance the current cursor position,
- o they do not expand other control characters to ^-es-
- capes, and
+ o they do not expand other control characters to ^-escapes, and
- o they truncate the string if it crosses the right mar-
- gin, rather than wrapping it around to the new line.
+ o they truncate the string if it crosses the right margin, rather
+ than wrapping it around to the new line.
- These functions end successfully on encountering a null
- cchar_t, or when they have filled the current line. If a
- complex character cannot completely fit at the end of the
- current line, the remaining columns are filled with the
- background character and rendition.
+ These functions end successfully on encountering a null cchar_t, or
+ when they have filled the current line. If a complex character cannot
+ completely fit at the end of the current line, the remaining columns
+ are filled with the background character and rendition.
-
-
RETURN VALUE
- All functions 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 imple-
- mentation returns an error if the window pointer is null.
+ X/Open does not define any error conditions. This implementation re-
+ turns an error if the window pointer is null.
- 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.
-