]> ncurses.scripts.mit.edu Git - ncurses.git/blobdiff - doc/html/man/curs_get_wstr.3x.html
ncurses 6.0 - patch 20170304
[ncurses.git] / doc / html / man / curs_get_wstr.3x.html
index b24f16563653aefb981fdfcc6876601f555f5917..853075a8cbf6ebd0f52207f58fc31325c5ef96a5 100644 (file)
@@ -26,7 +26,7 @@
   * sale, use or other dealings in this Software without prior written       *
   * authorization.                                                           *
   ****************************************************************************
-  * @Id: curs_get_wstr.3x,v 1.10 2017/01/07 19:25:15 tom Exp @
+  * @Id: curs_get_wstr.3x,v 1.11 2017/03/04 21:24:04 tom Exp @
 -->
 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN">
 <HTML>
        treated as an end-of-file condition, and the returned  ar-
        ray contains a <STRONG>WEOF</STRONG> followed by a null <STRONG>wchar_t</STRONG>.
 
-       X/Open  curses  documents these functions to pass an array
-       of <STRONG>wchar_t</STRONG>, but all of the vendors  implement  this  using
-       <STRONG>wint_t</STRONG>.
+       X/Open  curses documented these functions to pass an array
+       of <STRONG>wchar_t</STRONG> in 1997, but that was an error because of  this
+       part of the description:
+
+              The  effect  of <EM>get</EM><STRONG>_</STRONG><EM>wstr()</EM> is as though a series of
+              calls to <EM>get</EM><STRONG>_</STRONG><EM>wch()</EM> were made, until a newline char-
+              acter,  end-of-line character, or end-of-file char-
+              acter is processed.
+
+       The latter function <EM>get</EM><STRONG>_</STRONG><EM>wch()</EM> can return a negative value,
+       while  <STRONG>wchar_t</STRONG> is a unsigned type.  All of the vendors im-
+       plement this using <STRONG>wint_t</STRONG>, following the standard.
 
 
 </PRE><H2><a name="h2-SEE-ALSO">SEE ALSO</a></H2><PRE>