These routines return a string of characters in str,
extracted starting at the current cursor position in the
named window. Attributes are stripped from the charac-
@@ -78,42 +79,52 @@
All of the functions return ERR upon failure, or the num-
ber of characters actually read into the string.
+ X/Open defines no error conditions. In this implementa-
+ tion, if the window parameter is null or the str parameter
+ is null, a zero is returned.
+
+ 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.
+
Note that all routines except winnstr may be macros.
-
PORTABILITY
- The XSI Curses error conditions EILSEQ and EILOVERFLOW
- associated with extended-level conformance are not yet
- detected (this implementation does not yet support XPG4
- multibyte characters). SVr4 does not document whether a
- length limit includes or excludes the trailing NUL.
-
- The ncurses library extends the XSI description by allow-
- ing a negative value for n. In this case, the functions
+
+ SVr4 does not document whether a length limit includes or
+ excludes the trailing NUL.
+
+ The ncurses library extends the XSI description by allow-
+ ing a negative value for n. In this case, the functions
return the string ending at the right margin.