X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fterm_variables.3x.html;h=d26d21e0ccd24514f234056dde30b14ebd42585b;hp=089267d9384221d1ef4e596d9b7d79d08fe3b53c;hb=a8e3f06ac309504143cd56ac9ec55889bfdf4914;hpb=34d602f272c394e9a980438e636e1ce4d355f83b diff --git a/doc/html/man/term_variables.3x.html b/doc/html/man/term_variables.3x.html index 089267d9..d26d21e0 100644 --- a/doc/html/man/term_variables.3x.html +++ b/doc/html/man/term_variables.3x.html @@ -1,7 +1,6 @@ - +
+ +- term_variables(3x) term_variables(3x) --
+
SP, acs_map, boolcodes, boolfnames, boolnames, cur_term, numcodes, numfnames, numnames, strcodes, strfnames, strnames, ttytype - curses terminfo global variables --
+
#include <curses.h> #include <term.h> chtype acs_map[]; + + SCREEN * SP; + + TERMINAL * cur_term; + + char ttytype[]; + NCURSES_CONST char * const * boolcodes; NCURSES_CONST char * const * boolfnames; NCURSES_CONST char * const * boolnames; - TERMINAL * cur_term; + NCURSES_CONST char * const * numcodes; NCURSES_CONST char * const * numfnames; NCURSES_CONST char * const * numnames; + NCURSES_CONST char * const * strcodes; NCURSES_CONST char * const * strfnames; NCURSES_CONST char * const * strnames; - char ttytype[]; --
+
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. @@ -83,7 +87,8 @@ plications should treat them as read-only to avoid confus- ing the library. - Alternate Character Set Mapping + +
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 @@ -96,59 +101,83 @@ The comparable data for the wide-character library is a private variable. - Current Terminal Data + +
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 curs_initscr(3x) - and curs_initscr(3x). + 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. + from newterm or setupterm(3x) to reuse in set_term. + - Terminfo Names - The tic(1m) and infocmp(1m) programs use lookup tables for +
+ 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. + 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 "l" (ell) in - their names: boolfnames numfnames strfnames + The long terminfo capability names use a "l" (ell) in + their names: boolfnames, numfnames, and strfnames. - These are the short names for terminfo capabilities: bool- - names, numnames, and strnames. + 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. + These are the corresponding names used for termcap de- + scriptions: boolcodes, numcodes, and strcodes. - Terminal Type - On initialization of the curses or terminfo interfaces, - setupterm copies the terminal name to the array ttytype. +
+ 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. --
- The low-level terminfo interface is initialized using - curs_terminfo(3x). The upper-level curses interface uses the + +
+ In addition to the variables, <term.h> also defines a sym- + bol for each terminfo capability long name. These are in + terms of the symbol CUR, which is defined + + #define CUR ((TERMTYPE *)(cur_term))-> + + These symbols provide a faster method of accessing termin- + fo capabilities than using tigetstr(3x), etc. + + The actual definition of CUR depends upon the implementa- + tion, 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 +
+ 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, + 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 Terminfo Names section. + Most, but not all, base the definition upon the cur_term + variable. --
+ +
curses(3x), curs_terminfo(3x), curs_threads(3x), terminfo(5). @@ -156,10 +185,23 @@ term_variables(3x)-