- This page summarizes variables provided by the curses li-
- brary's low-level terminfo interface. A more complete de-
- scription is given in the curs_terminfo(3x) manual page.
-
- Depending on the configuration, these may be actual vari-
- ables, or macros (see curs_threads(3x)) which provide
- read-only access to curses's state. In either case, ap-
- plications should treat them as read-only to avoid confus-
- ing the library.
-
- AlternateCharacterSetMapping
- After initializing the curses or terminfo interfaces, the
- acs_map array holds information used to translate cells
- with the A_ALTCHARSET video attribute into line-drawing
- characters.
-
- The encoding of the information in this array has changed
- periodically. Application developers need only know that
- it is used for the "ACS_" constants in <curses.h>.
-
- The comparable data for the wide-character library is a
- private variable.
-
- CurrentTerminalData
- After initializing the curses or terminfo interfaces, the
- cur_term contains data describing the current terminal.
- This variable is also set as a side-effect of set_term(3x)
- and delscreen(3x).
-
- It is possible to save a value of cur_term for subsequent
- use as a parameter to set_term, for switching between
- screens. Alternatively, one can save the return value
- from newterm or setupterm to reuse in set_term.
-
- TerminfoNames
- The tic(1) and infocmp(1) programs use lookup tables for
- the long and short names of terminfo capabilities, as well
- as the corresponding names for termcap capabilities.
- These are available to other applications, though the
- hash-tables are not available.
-
- The long terminfo capability names use a "l" (ell) in
- their names: boolfnames numfnames strfnames
-
- These are the short names for terminfo capabilities: bool-
- names, numnames, and strnames.
-
- These are the corresponding names used for termcap de-
- scriptions: boolcodes, numcodes, and strcodes.
-
- TerminalType
- On initialization of the curses or terminfo interfaces,
- setupterm copies the terminal name to the array ttytype.
+ NCURSES_CONSTchar*constnumcodes[];
+ NCURSES_CONSTchar*constnumfnames[];
+ NCURSES_CONSTchar*constnumnames[];
+ NCURSES_CONSTchar*conststrcodes[];
+ NCURSES_CONSTchar*conststrfnames[];
+ NCURSES_CONSTchar*conststrnames[];
-
-
NOTES
- The low-level terminfo interface is initialized using se-
- tupterm(3x). The upper-level curses interface uses the
- low-level terminfo interface, internally.
+
+ This page summarizes variables provided by the curses library's low-
+ level terminfo interface. A more complete description is given in the
+ curs_terminfo(3x) manual page.
-
-
PORTABILITY
- X/Open Curses does not describe any of these except for
- cur_term. (The inclusion of cur_term appears to be an
- oversight, since other comparable low-level information is
- omitted by X/Open).
+ Depending on the configuration, these may be actual variables, or
+ macros (see curs_threads(3x)) which provide read-only access to
+ curses's state. In either case, applications should treat them as
+ read-only to avoid confusing the library.
- Other implementations may have comparable variables. Some
- implementations provide the variables in their libraries,
- but omit them from the header files.
+
+ After initializing the curses or terminfo interfaces, the acs_map array
+ holds information used to translate cells with the A_ALTCHARSET video
+ attribute into line-drawing characters.
-
-
SEE ALSO
- curses(3x), curs_terminfo(3x), curs_threads(3x), termin-
- fo(3x), terminfo(5).
+ The encoding of the information in this array has changed periodically.
+ Application developers need only know that it is used for the "ACS_"
+ constants in <curses.h>.
+
+ The comparable data for the wide-character library is a private
+ variable.
+
+
+
+ After initializing the curses or terminfo interfaces, the cur_term
+ contains data describing the current terminal. This variable is also
+ set as a side-effect of set_term(3x) and delscreen(3x).
+
+ It is possible to save a value of cur_term for subsequent use as a
+ parameter to set_term, for switching between screens. Alternatively,
+ one can save the return value from newterm or setupterm(3x) to reuse in
+ set_term.
+
+
+
+ The tic(1) and infocmp(1) programs use lookup tables for the long and
+ short names of terminfo capabilities, as well as the corresponding
+ names for termcap capabilities. These are available to other
+ applications, although the hash-tables used by the terminfo and termcap
+ functions are not available.
+
+ The long terminfo capability names use a "f" (eff) in their names:
+ boolfnames, numfnames, and strfnames.
+
+ These are the short names for terminfo capabilities: boolnames,
+ numnames, and strnames.
+
+ These are the corresponding names used for termcap descriptions:
+ boolcodes, numcodes, and strcodes.
+
+
+
+ A terminal description begins with one or more terminal names separated
+ by "|" (vertical bars). On initialization of the curses or terminfo
+ interfaces, setupterm(3x) copies the terminal names to the array
+ ttytype.
+
+
+
+ In addition to the variables, <term.h> also defines a symbol for each
+ terminfo capability longname. These are in terms of the symbol CUR,
+ which is defined
+
+ #define CUR ((TERMTYPE *)(cur_term))->
+
+ These symbols provide a faster method of accessing terminfo
+ capabilities than using tigetstr(3x), etc.
+
+ The actual definition of CUR depends upon the implementation, but each
+ terminfo library provides these long names defined to point into the
+ current terminal description loaded into memory.
+
+
+
+ The low-level terminfo interface is initialized using setupterm(3x).
+ The upper-level curses interface uses the low-level terminfo interface,
+ internally.
+
+
+
+ X/Open Curses does not describe any of these except for cur_term. (The
+ inclusion of cur_term appears to be an oversight, since other
+ comparable low-level information is omitted by X/Open).
+
+ Other implementations may have comparable variables. Some
+ implementations provide the variables in their libraries, but omit them
+ from the header files.
+
+ All implementations which provide terminfo interfaces add definitions
+ as described in the TerminfoNames section. Most, but not all, base
+ the definition upon the cur_term variable.
+
+
+