termcap(3x)
_________________________________________________________________
tgetent, tgetnum, tgetflag, tgetstr, tgoto, tputs Subroutine
terminal independent operation routines
_________________________________________________________________
SYNTAX
char PC;
char *BC;
char *UP;
short ospeed;
tgetent(bp, name)
char *bp, *name;
tgetnum(id)
char *id;
tgetflag(id)
char *id;
char *
tgetstr(id, area)
char *id, **area;
char *
tgoto(cm, destcol, destline)
char *cm;
int destcol, destline;
tputs(cp, affcnt, outc)
register char *cp;
int affcnt;
int (*outc)();
DESCRIPTION
These functions extract and use routines from the terminal
capability data base termcap(5). These are obsolete low level
routines; see terminfo(4) for an equivalent but more modern
package, and curses(3X) for a higher level package.
Tgetent extracts the entry for terminal name into the buffer at
bp. Bp should be a character buffer of size 1024 and must be
retained through all subsequent calls to tgetnum, tgetflag, and
tgetstr. Tgetent returns -1 if it cannot open the termcap file, 0
if the terminal name given does not have an entry, and 1 if all
goes well.
DG/UX 4.00 Page 1
Licensed material--property of copyright holder(s)
termcap(3x)
Tgetent looks in the environment for a TERMCAP variable. If it
is found, and its value does not begin with a slash, and the
terminal type name is the same as the environment string TERM,
the TERMCAP string is used instead of reading the termcap file.
If it does begin with a slash, the string is used as a path name
rather than /etc/termcap. This can speed up entry into programs
that call tgetent; it will also help you debug new terminal
descriptions or to make one for your terminal if you can't write
the file /etc/termcap.
Tgetnum gets the numeric value of capability id, returning -1 if
is not given for the terminal. Tgetflag returns 1 if the
specified capability is present in the terminal's entry, 0 if it
is not. Tgetstr gets the string value of capability id, placing
it in the buffer at *area, and advancing the area pointer. It
decodes the abbreviations for this field described in termcap(5),
except for cursor addressing and padding information.
Tgoto returns a cursor addressing string decoded from cm to go to
column destcol in line destline. It uses the external variables
UP (from the up capability) and BC (if bc is given rather than
bs) if necessary to avoid placing \n, \r, ^D, ^H, or ^@ in the
returned string.
Programs which call tgoto should be sure to turn off tab
expansion into spaces in the terminal driver since tgoto may now
output a tab. Note that programs using termcap should turn off
tab expansion anyway since some terminals use the tab character
(^I) for other functions. If a % sequence is given which is not
understood, then tgoto returns "OOPS".
Tputs decodes the leading padding information of the string cp;
affcnt is the number of lines affected by the operation, or 1 if
this is not applicable. Outc is a routine that is called with
each character in turn. The external variable ospeed should
contain the output speed of the terminal as encoded by ioctl (2)
The external variable PC should contain a pad character to be
used (from the pc capability) if a null (^@) is inappropriate.
FILES
/lib/libtermcap.a -ltermcap library
/etc/termcap terminal information data base
SEE ALSO
curses(3x), terminfo (4), termcap (5).
captoinfo(1M), infocmp (1M) in the System Manager's Reference for
the DG/UX System.
DG/UX 4.00 Page 2
Licensed material--property of copyright holder(s)