Cap - Online Linux Manual PageSection : 3
Updated : 2023-02-13
Source : perl v5.36.0
Note : User Contributed Perl Documentation
NAMETerm::Cap − Perl termcap interface
SYNOPSIS​ require Term::Cap; ​ $terminal = Term::Cap−>Tgetent({ TERM => undef, OSPEED => $ospeed }); ​ $terminal−>Trequire(qw/ce ku kd/); ​ $terminal−>Tgoto('cm', $col, $row, $FH); ​ $terminal−>Tputs('dl', $count, $FH); ​ $terminal−>Tpad($string, $count, $FH);
DESCRIPTIONThese are low-level functions to extract and use capabilities from a terminal capability (termcap) database. More information on the terminal capabilities will be found in the termcap manpage on most Unix-like systems.
METHODSThe output strings for Tputs are cached for counts of 1 for performance. ​Tgoto and Tpad do not cache. \*(C`$self\->{_xx}\*(C'\fR is the raw termcap data and \*(C`$self\->{xx}\*(C'\fR is the cached version. ​ print $terminal−>Tpad($self−>{_xx}, 1); ​Tgoto, Tputs, and Tpad return the string and will also output the string to $FH if specified. Tgetent Returns a blessed object reference which the user can then use to send the control strings to the terminal using Tputs and Tgoto. The function extracts the entry of the specified terminal type TERM (defaults to the environment variable TERM) from the database. It will look in the environment for a TERMCAP variable. If found, and the 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 a termcap file. If it does begin with a slash, the string is used as a path name of the termcap file to search. If TERMCAP does not begin with a slash and name is different from TERM, Tgetent searches the files $HOME/.termcap, /etc/termcap, and /usr/share/misc/termcap, in that order, unless the environment variable TERMPATH exists, in which case it specifies a list of file pathnames (separated by spaces or colons) to be searched instead. Whenever multiple files are searched and a tc field occurs in the requested entry, the entry it names must be found in the same file or one of the succeeding files. If there is a \*(C`:tc=...:\*(C'\fR in the \fITERMCAP\fR environment variable string it will continue the search in the files as above. The extracted termcap entry is available in the object as \*(C`$self\->{TERMCAP}\*(C'\fR. It takes a hash reference as an argument with two optional keys: OSPEED The terminal output bit rate (often mistakenly called the baud rate) for this terminal − if not set a warning will be generated and it will be defaulted to 9600. OSPEED can be specified as either a POSIX termios/SYSV termio speeds (where 9600 equals 9600) or an old DSD-style speed ( where 13 equals 9600). TERM The terminal type whose termcap entry will be used − if not supplied it will default to $ENV{TERM}: if that is not set then Tgetent will croak. It calls \*(C`croak\*(C'\fR on failure. Tpad Outputs a literal string with appropriate padding for the current terminal. It takes three arguments: $string The literal string to be output. If it starts with a number and an optional ​'*' then the padding will be increased by an amount relative to this number, if the '*' is present then this amount will be multiplied by $cnt. This part of $string is removed before output/ $cnt Will be used to modify the padding applied to string as described above. $FH An optional filehandle (or IO::Handle ) that output will be printed to. The padded $string is returned. Tputs Output the string for the given capability padded as appropriate without any parameter substitution. It takes three arguments: $cap The capability whose string is to be output. $cnt A count passed to Tpad to modify the padding applied to the output string. If $cnt is zero or one then the resulting string will be cached. $FH An optional filehandle (or IO::Handle ) that output will be printed to. The appropriate string for the capability will be returned. Tgoto ​Tgoto decodes a cursor addressing string with the given parameters. There are four arguments: $cap The name of the capability to be output. $col The first value to be substituted in the output string ( usually the column in a cursor addressing capability ) $row The second value to be substituted in the output string (usually the row in cursor addressing capabilities) $FH An optional filehandle (or IO::Handle ) to which the output string will be printed. Substitutions are made with $col and $row in the output string with the following sprintf() line formats: ​ %% output `%' ​ %d output value as in printf %d ​ %2 output value as in printf %2d ​ %3 output value as in printf %3d ​ %. output value as in printf %c ​ %+x add x to value, then do %. ​ ​ %>xy if value > x then add y, no output ​ %r reverse order of two parameters, no output ​ %i increment by one, no output ​ %B BCD (16*(value/10)) + (value%10), no output ​ ​ %n exclusive−or all parameters with 0140 (Datamedia 2500) ​ %D Reverse coding (value − 2*(value%16)), no output (Delta Data) The output string will be returned. Trequire Takes a list of capabilities as an argument and will croak if one is not found.
EXAMPLES​ use Term::Cap; ​ ​ # Get terminal output speed ​ require POSIX; ​ my $termios = POSIX::Termios−>new; ​ $termios−>getattr; ​ my $ospeed = $termios−>getospeed; ​ ​ # Old−style ioctl code to get ospeed: ​ # require 'ioctl.pl'; ​ # ioctl(TTY,$TIOCGETP,$sgtty); ​ # ($ispeed,$ospeed) = unpack('cc',$sgtty); ​ ​ # allocate and initialize a terminal structure ​ my $terminal = Term::Cap−>Tgetent({ TERM => undef, OSPEED => $ospeed }); ​ ​ # require certain capabilities to be available ​ $terminal−>Trequire(qw/ce ku kd/); ​ ​ # Output Routines, if $FH is undefined these just return the string ​ ​ # Tgoto does the % expansion stuff with the given args ​ $terminal−>Tgoto('cm', $col, $row, $FH); ​ ​ # Tputs doesn't do any % expansion. ​ $terminal−>Tputs('dl', $count = 1, $FH);
COPYRIGHT AND LICENSECopyright 1995−2015 (c) perl5 porters. This software is free software and can be modified and distributed under the same terms as Perl itself. Please see the file README in the Perl source distribution for details of the Perl license.
AUTHORThis module is part of the core Perl distribution and is also maintained for CPAN by Jonathan Stowe <jns@gellyfish.co.uk>. The code is hosted on Github: https://github.com/jonathanstowe/Term−Cap please feel free to fork, submit patches etc, etc there.
SEE ALSO​termcap (5) 0
Johanes Gumabo
Data Size   :   25,137 byte
man-Term::Cap.3pmBuild   :   2024-12-05, 20:55   :  
Visitor Screen   :   x
Visitor Counter ( page / site )   :   2 / 165,322
Visitor ID   :     :  
Visitor IP   :   13.58.61.176   :  
Visitor Provider   :   AMAZON-02   :  
Provider Position ( lat x lon )   :   39.962500 x -83.006100   :   x
Provider Accuracy Radius ( km )   :   1000   :  
Provider City   :   Columbus   :  
Provider Province   :   Ohio ,   :   ,
Provider Country   :   United States   :  
Provider Continent   :   North America   :  
Visitor Recorder   :   Version   :  
Visitor Recorder   :   Library   :  
Online Linux Manual Page   :   Version   :   Online Linux Manual Page - Fedora.40 - march=x86-64 - mtune=generic - 24.12.05
Online Linux Manual Page   :   Library   :   lib_c - 24.10.03 - march=x86-64 - mtune=generic - Fedora.40
Online Linux Manual Page   :   Library   :   lib_m - 24.10.03 - march=x86-64 - mtune=generic - Fedora.40
Data Base   :   Version   :   Online Linux Manual Page Database - 24.04.13 - march=x86-64 - mtune=generic - fedora-38
Data Base   :   Library   :   lib_c - 23.02.07 - march=x86-64 - mtune=generic - fedora.36
Very long time ago, I have the best tutor, Wenzel Svojanovsky . If someone knows the email address of Wenzel Svojanovsky , please send an email to johanes_gumabo@yahoo.co.id .
If error, please print screen and send to johanes_gumabo@yahoo.co.id
Under development. Support me via PayPal.
ERROR : Need New Coding :         (parse_manual_page_|249|Term::Cap.3pm|24/25|el══─{─══.|.el══─{─══. ds C` )         (htmlprn|149|Term::Cap.3pm|24/25|.el══─{─══. ds C` |.el══─{─══. ds C` )         (parse_manual_page_|249|Term::Cap.3pm|27|br══─}─══|'br══─}─══ )         (htmlprn|149|Term::Cap.3pm|27|'br══─}─══ |'br══─}─══ )         (rof_escape_sequence|91|Term::Cap.3pm|85|\*(C`$self\->{_xx}\*(C'\fR is the raw termcap |\&\fBTgoto\fR and \fBTpad\fR do not cache. \f(CW\*(C`$self\->{_xx}\*(C'\fR is the raw termcap )         (rof_escape_sequence|91|Term::Cap.3pm|86|\*(C`$self\->{xx}\*(C'\fR is the cached version. |data and \f(CW\*(C`$self\->{xx}\*(C'\fR is the cached version. )         (rof_escape_sequence|91|Term::Cap.3pm|117|\*(C`:tc=...:\*(C'\fR in the \fITERMCAP\fR |succeeding files. If there is a \f(CW\*(C`:tc=...:\*(C'\fR in the \fITERMCAP\fR )         (rof_escape_sequence|91|Term::Cap.3pm|122|\*(C`$self\->{TERMCAP}\*(C'\fR. |as \f(CW\*(C`$self\->{TERMCAP}\*(C'\fR. )         (rof_escape_sequence|91|Term::Cap.3pm|140|\*(C`croak\*(C'\fR on failure. |It calls \f(CW\*(C`croak\*(C'\fR on failure. )