X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_get_wstr.3x.html;h=0e47dcc2e11ce0eb91c132a0f387c85e01c45951;hp=36ad16b1d5c30ba4ef2f214f2707a5c106cd31f9;hb=9193d076200365eeb5ff932acdbbdcc5e452292c;hpb=ed646e3f683083e787c6ba773364401dc9fa9d40 diff --git a/doc/html/man/curs_get_wstr.3x.html b/doc/html/man/curs_get_wstr.3x.html index 36ad16b1..0e47dcc2 100644 --- a/doc/html/man/curs_get_wstr.3x.html +++ b/doc/html/man/curs_get_wstr.3x.html @@ -1,6 +1,6 @@ - + curs_get_wstr 3x - + @@ -124,9 +124,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 +141,24 @@
        wchar_t  is  a  unsigned type.  All of the vendors implement this using
        wint_t, following the standard.
 
+       X/Open Curses issue 7 is unclear regarding whether the terminating null
+       wchar_t  value is counted in the length parameter n.  X/Open Curses is-
+       sue 7 revised the corresponding description of wgetnstr to address this
+       issue.   The unrevised description of wget_nwstr can be interpreted ei-
+       ther 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).