Text::ANSI::Tabs - Tab expand and unexpand with ANSI sequence
use Text::ANSI::Tabs qw(:all); use Text::ANSI::Tabs qw(ansi_expand ansi_unexpand); ansi_expand($text); ansi_unexpand($text); use Text::ANSI::Tabs; Text::ANSI::Tabs::expand($text); Text::ANSI::Tabs::unexpand($text);
Version 1.0501
ANSI sequence and Unicode wide characters aware version of Text::Tabs.
There are exportable functions start with ansi_ prefix, and unexportable functions without them.
ansi_
Expand tabs. Interface is compatible with Text::Tabs::expand().
Default tabstop is 8, and can be accessed through $Text::ANSI::Tabs::tabstop variable.
$Text::ANSI::Tabs::tabstop
Option for the underlying Text::ANSI::Fold object can be passed by first parameter as an array reference, as well as Text::ANSI::Tabs->configure call.
Text::ANSI::Fold
Text::ANSI::Tabs->configure
my $opt = [ tabhead => 'T', tabspace => '_' ]; ansi_expand($opt, @text); Text::ANSI::Tabs->configure(tabstyle => 'bar'); ansi_expand(@text);
See Text::ANSI::Fold for detail.
Unexpand tabs. Interface is compatible with Text::Tabs::unexpand(). Default tabstop is same as ansi_expand.
ansi_expand
Please be aware that, current implementation may add and/or remove some redundant color designation code.
Confiugre and return the underlying Text::ANSI::Fold object. Related parameters are those:
Set the value of variable $Text::ANSI::Tabs::tabstop to num.
Tab character is converted to tabhead and following tabspace characters. Both are white space by default.
Set tab expansion style. This parameter set both tabhead and tabspace at once according to the given style name. Each style has two values for tabhead and tabspace.
If two style names are combined, like symbol,space, use symbols's tabhead and space's tabspace.
symbol,space
symbols
space
By default, unexpand converts two or more consecutive whitespace characters into tab characters. This parameter specifies the minimum number of whitespace characters to be converted to tabs. Specifying it to 1 will convert all possible whitespace characters.
App::ansiexpand, https://github.com/tecolicom/App-ansiexpand
Text::ANSI::Tabs, https://github.com/tecolicom/Text-ANSI-Tabs
Text::ANSI::Fold::Util, https://github.com/tecolicom/Text-ANSI-Fold-Util
Text::ANSI::Fold, https://github.com/tecolicom/Text-ANSI-Fold
Text::Tabs
Kazumasa Utashiro
Copyright 2021-2024 Kazumasa Utashiro.
This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
To install Text::ANSI::Tabs, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Text::ANSI::Tabs
CPAN shell
perl -MCPAN -e shell install Text::ANSI::Tabs
For more information on module installation, please visit the detailed CPAN module installation guide.