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 @@
- +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. +
Functions: curses(3x), curs_get_wch(3x), curs_getstr(3x).