Lines Matching +full:kind +full:- +full:of +full:- +full:intr

2 .\" Copyright 2018-2023,2024 Thomas E. Dickey                                *
3 .\" Copyright 1998-2010,2017 Free Software Foundation, Inc.                  *
5 .\" Permission is hereby granted, free of charge, to any person obtaining a  *
6 .\" copy of this software and associated documentation files (the            *
10 .\" copies of the Software, and to permit persons to whom the Software is    *
14 .\" in all copies or substantial portions of the Software.                   *
16 .\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS  *
17 .\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF               *
20 .\" DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR    *
21 .\" OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR    *
24 .\" Except as contained in this notice, the name(s) of the above copyright   *
31 .TH curs_getstr 3X 2024-04-20 "ncurses @NCURSES_MAJOR@.@NCURSES_MINOR@" "Library calls"
55 \fB\%mvwgetnstr\fP \-
74 is equivalent to a series of calls to
80 In all instances, the end of the string is terminated
87 thus preventing a possible overflow of the input buffer.
98 at the end of the buffer, moving the cursor to the left.
105 leaving the cursor at the beginning of the buffer.
109 backspace is echoed as deletion of the previous character
128 characters, letting the application prevent overflow of the
131 All of these functions return the integer \fBOK\fP upon successful completion.
158 Any of these functions other than
172 The use of
183 or if the lower-level \fBwgetch\fP(3X) call returns an \fBERR\fP.
195 (being, in fact, the low-order eight bits of the key's KEY_ value).
204 \*(``read at most \fIn\fP\-1 bytes\*(''
206 As of 2018, some implementations count it, some do not:
210 Solaris SVr4 and NetBSD curses count the NUL as part of the limit.
213 its wide-character \fBwget_nstr\fP reserves a NUL,
217 a negative value of \fIn\fP tells \fBwgetnstr\fP to assume that the
221 (or anything related to negative or zero values of \fIn\fP),
237 from \fBwgetstr\fP, and treats the \fIn\fP parameter of \fBwgetnstr\fP
241 or a larger (system-dependent) value
247 Although \fBgetnstr\fP is equivalent to a series of calls to \fBgetch\fP,
248 it also makes changes to the curses modes to allow simple editing of
251 \fBgetnstr\fP saves the current value of the \fBnl\fP, \fBecho\fP,
258 \fBgetnstr\fP handles the echoing of characters,
266 Other implementations differ in their treatment of special characters:
272 echoing within \fBgetnstr\fP or as a side-effect of the \fBgetch\fP calls.
277 That may have been done to make function- and cursor-keys work;
281 \fI\%ncurses\fP has provided signal handlers for INTR and QUIT
291 SVr4-curses, e.g., allowing one to enter a \fB^C\fP into the buffer.
293 \fB\%curs_get_wstr\fP(3X) describes comparable functions of the
295 library in its wide-character configuration