+ Note that echo, noecho, halfdelay, intrflush, meta, nl, nonl, nodelay,
+ notimeout, noqiflush, qiflush, timeout, and wtimeout may be macros.
+
+ The noraw and nocbreak calls follow historical practice in that they
+ attempt to restore to normal ("cooked") mode from raw and cbreak modes
+ respectively. Mixing raw/noraw and cbreak/nocbreak calls leads to tty
+ driver control states that are hard to predict or understand; it is not
+ recommended.
+
+
This implementation provides four functions which may be used to detect
if the corresponding flags were set or reset:
@@ -265,78 +276,67 @@
-1 if the curses library was not initialized.
- These routines are specific to ncurses. They were not supported on
+ These routines are specific to ncurses. They were not supported on
Version 7, BSD or System V implementations. It is recommended that any
code depending on ncurses extensions be conditioned using
NCURSES_VERSION.
- Except as noted in the section on extensions, these functions are
+ Except as noted in the section on extensions, these functions are
described in the XSI Curses standard, Issue 4.
The ncurses library obeys the XPG4 standard and the historical practice
- of the AT&T curses implementations, in that the echo bit is cleared
- when curses initializes the terminal state. BSD curses differed from
- this slightly; it left the echo bit on at initialization, but the BSD
- raw call turned it off as a side-effect. For best portability, set
- echo or noecho explicitly just after initialization, even if your
+ of the AT&T curses implementations, in that the echo bit is cleared
+ when curses initializes the terminal state. BSD curses differed from
+ this slightly; it left the echo bit on at initialization, but the BSD
+ raw call turned it off as a side-effect. For best portability, set
+ echo or noecho explicitly just after initialization, even if your
program remains in cooked mode.
- The XSI Curses standard is ambiguous on the question of whether raw
- should disable the CRLF translations controlled by nl and nonl. BSD
- curses did turn off these translations; AT&T curses (at least as late
- as SVr1) did not. We chose to do so, on the theory that a programmer
- requesting raw input wants a clean (ideally 8-bit clean) connection
+ The XSI Curses standard is ambiguous on the question of whether raw
+ should disable the CRLF translations controlled by nl and nonl. BSD
+ curses did turn off these translations; AT&T curses (at least as late
+ as SVr1) did not. We chose to do so, on the theory that a programmer
+ requesting raw input wants a clean (ideally 8-bit clean) connection
that the operating system will not alter.
When keypad is first enabled, ncurses loads the key-definitions for the
- current terminal description. If the terminal description includes
- extended string capabilities, e.g., from using the -x option of tic,
- then ncurses also defines keys for the capabilities whose names begin
- with "k". The corresponding keycodes are generated and (depending on
- previous loads of terminal descriptions) may differ from one execution
+ current terminal description. If the terminal description includes
+ extended string capabilities, e.g., from using the -x option of tic,
+ then ncurses also defines keys for the capabilities whose names begin
+ with "k". The corresponding keycodes are generated and (depending on
+ previous loads of terminal descriptions) may differ from one execution
of a program to the next. The generated keycodes are recognized by the
- keyname function (which will then return a name beginning with "k"
- denoting the terminfo capability name rather than "K", used for curses
- key-names). On the other hand, an application can use define_key to
- establish a specific keycode for a given string. This makes it
- possible for an application to check for an extended capability's
- presence with tigetstr, and reassign the keycode to match its own
+ keyname function (which will then return a name beginning with "k"
+ denoting the terminfo capability name rather than "K", used for curses
+ key-names). On the other hand, an application can use define_key to
+ establish a specific keycode for a given string. This makes it
+ possible for an application to check for an extended capability's
+ presence with tigetstr, and reassign the keycode to match its own
needs.
Low-level applications can use tigetstr to obtain the definition of any
- particular string capability. Higher-level applications which use the
- curseswgetch and similar functions to return keycodes rely upon the
+ particular string capability. Higher-level applications which use the
+ curseswgetch and similar functions to return keycodes rely upon the
order in which the strings are loaded. If more than one key definition
- has the same string value, then wgetch can return only one keycode.
+ has the same string value, then wgetch can return only one keycode.
Most curses implementations (including ncurses) load key definitions in
- the order defined by the array of string capability names. The last
- key to be loaded determines the keycode which will be returned. In
- ncurses, you may also have extended capabilities interpreted as key
- definitions. These are loaded after the predefined keys, and if a
- capability's value is the same as a previously-loaded key definition,
+ the order defined by the array of string capability names. The last
+ key to be loaded determines the keycode which will be returned. In
+ ncurses, you may also have extended capabilities interpreted as key
+ definitions. These are loaded after the predefined keys, and if a
+ capability's value is the same as a previously-loaded key definition,
the later definition is the one used.
-
- Note that echo, noecho, halfdelay, intrflush, meta, nl, nonl, nodelay,
- notimeout, noqiflush, qiflush, timeout, and wtimeout may be macros.
-
- The noraw and nocbreak calls follow historical practice in that they
- attempt to restore to normal ("cooked") mode from raw and cbreak modes
- respectively. Mixing raw/noraw and cbreak/nocbreak calls leads to tty
- driver control states that are hard to predict or understand; it is not
- recommended.
-
-