X-Git-Url: https://ncurses.scripts.mit.edu/?a=blobdiff_plain;ds=sidebyside;f=doc%2Fhtml%2Fman%2Fcurs_get_wstr.3x.html;h=69517d68af2ecdd693ebbc759792977d074fa75f;hb=3ab4db240283db0682a66a8587f2174508348bc6;hp=36ad16b1d5c30ba4ef2f214f2707a5c106cd31f9;hpb=ed646e3f683083e787c6ba773364401dc9fa9d40;p=ncurses.git diff --git a/doc/html/man/curs_get_wstr.3x.html b/doc/html/man/curs_get_wstr.3x.html index 36ad16b1..69517d68 100644 --- a/doc/html/man/curs_get_wstr.3x.html +++ b/doc/html/man/curs_get_wstr.3x.html @@ -1,6 +1,6 @@
- +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,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).