table of contents
Term::Terminfo(3pm) | User Contributed Perl Documentation | Term::Terminfo(3pm) |
NAME¶
"Term::Terminfo" - access the terminfo database
SYNOPSIS¶
use Term::Terminfo; my $ti = Term::Terminfo->new; printf "This terminal %s do overstrike\n", $ti->getflag('os') ? "can" : "cannot"; printf "Tabs on this terminal are initially every %d columns\n", $ti->getnum('it'); printf "This terminal %s do overstrike\n", $ti->flag_by_varname('over_strike') ? "can" : "cannot"; printf "Tabs on this terminal are initially every %d columns\n", $ti->num_by_varname('init_tabs');
DESCRIPTION¶
Objects in this class provide access to terminfo database entires.
This database provides information about a terminal, in three separate sets of capabilities. Flag capabilities indicate the presence of a particular ability, feature, or bug simply by their presence. Number capabilities give the size, count or other numeric detail of some feature of the terminal. String capabilities are usually control strings that the terminal will recognise, or send.
Capabilities each have two names; a short name called the capname, and a longer name called the varname. This class provides two sets of methods, one that works on capnames, one that work on varnames.
This module optionally uses unibilium to access the terminfo(5) database, if it is available at compile-time. If not, it will use <term.h> and -lcurses. For more detail, see the "SEE ALSO" section below.
CONSTRUCTOR¶
new¶
$ti = Term::Terminfo->new( $termtype )
Constructs a new "Term::Terminfo" object representing the given termtype. If $termtype is not defined, $ENV{TERM} will be used instead. If that variable is empty, "vt100" will be used.
METHODS¶
getflag¶
getnum¶
getstr¶
$bool = $ti->getflag( $capname ) $num = $ti->getnum( $capname ) $str = $ti->getstr( $capname )
Returns the value of the flag, number or string capability of the given capname.
flag_by_varname¶
num_by_varname¶
str_by_varname¶
$bool = $ti->flag_by_varname( $varname ) $num = $ti->num_by_varname( $varname ) $str = $ti->str_by_varname( $varname )
Returns the value of the flag, number or string capability of the given varname.
flag_capnames¶
num_capnames¶
str_capnames¶
@capnames = $ti->flag_capnames @capnames = $ti->num_capnames @capnames = $ti->str_capnames
Return lists of the capnames of the supported flags, numbers, and strings
flag_varnames¶
num_varnames¶
str_varnames¶
@varnames = $ti->flag_varnames @varnames = $ti->num_varnames @varnames = $ti->str_varnames
Return lists of the varnames of the supported flags, numbers, and strings
TODO¶
This distribution provides a small accessor interface onto terminfo. It was originally created simply so I can get at the "bce" capability flag of the current terminal, because screen unlike every other terminal ever, doesn't do this. Grrr.
It probably also wants more accessors for things like "tparm" and "tputs". I may at some point consider them.
SEE ALSO¶
- •
- "unibilium" - a terminfo parsing library - <https://github.com/mauke/unibilium>
AUTHOR¶
Paul Evans <leonerd@leonerd.org.uk>
2020-11-26 | perl v5.40.0 |