X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_get_wstr.3x.html;h=4169df236c61f4b06117f7fcf4a5ddf4c1bf1760;hp=36ad16b1d5c30ba4ef2f214f2707a5c106cd31f9;hb=a90dd7b66fa711acd24d8181ea20e4f57d4b36cd;hpb=ed646e3f683083e787c6ba773364401dc9fa9d40;ds=sidebyside diff --git a/doc/html/man/curs_get_wstr.3x.html b/doc/html/man/curs_get_wstr.3x.html index 36ad16b1..4169df23 100644 --- a/doc/html/man/curs_get_wstr.3x.html +++ b/doc/html/man/curs_get_wstr.3x.html @@ -1,6 +1,7 @@ - + curs_get_wstr 3x - + @@ -124,9 +125,9 @@

PORTABILITY

        These functions are described in The Single Unix Specification, Version
-       2.   No  error conditions are defined.  This implementation returns ERR
+       2.   No  error conditions are defined.  This implementation returns ERR
        if the window pointer is null, or if the lower-level wget_wch call  re-
-       turns  an ERR.  In the latter case, an ERR return without other data is
+       turns  an ERR.  In the latter case, an ERR return without other data is
        treated as an end-of-file condition, and the returned array contains  a
        WEOF followed by a null wchar_t.
 
@@ -141,6 +142,25 @@
        wchar_t  is  a  unsigned type.  All of the vendors implement this using
        wint_t, following the standard.
 
+       X/Open Curses, Issue 7 (2009) is unclear regarding whether  the  termi-
+       nating null wchar_t value is counted in the length parameter n.  X/Open
+       Curses, Issue 7 revised the corresponding description  of  wgetnstr  to
+       address this issue.  The unrevised description of wget_nwstr can be in-
+       terpreted either way.  This implementation counts the terminator in the
+       length.
+
+       X/Open  Curses  does  not specify what happens if the length n is nega-
+       tive.
+
+       o   For analogy with wgetnstr, ncurses  6.2  uses  a  limit  (based  on
+           LINE_MAX).
+
+       o   Some  other  implementations (such as Solaris xcurses) do the same,
+           while others (PDCurses) do not allow this.
+
+       o   NetBSD 7 curses imitates ncurses 6.1 in this regard, treating a  -1
+           as an indefinite number of characters.
+
 
 

SEE ALSO

        Functions: curses(3x), curs_get_wch(3x), curs_getstr(3x).