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