NAME

Term::Highlight - perl module to highlight regexp patterns on terminals

SYNOPSIS

use Term::Highlight;

$obj = Term::Highlight->new( tagtype => $TAGTYPE );

$obj->LoadArgs( \@args );

$obj->LoadPatterns( \@ptns );

$obj->ClearPatterns( );

$obj->Process( \$string );

Currently term and term-debug tagtypes are supported. If tagtype is term then boundaries of found patterns will be enclosed in terminal color escape sequence tags, if tagtype is term-debug then they will be marked by symbolic sequences.

DESCRIPTION

Term::Highlight is perl module aimed to support highlighting of patterns on color terminals. It supports 256 color terminals and older 8 color terminals.

EXPORTS

LoadPatterns

expects reference to array of references to arrays of structure [ $pattern, $fg, $bold, $bg ]. Load patterns to be processed.

ClearPatterns

clear loaded patterns.

LoadArgs

expects array of references to strings. Loads patterns to be processed. This is just a convenient version of LoadPatterns. Example of array to be loaded: [ "-46", "-25.1", "-i", "\bw.*?\b", "-100" ].

Process

expects reference to string. Make substitution of color tags inside the string. Returns count of found matches.

SEE ALSO

hl(1)

AUTHOR

A. Radkov, <alexey.radkov@gmail.com>

COPYRIGHT AND LICENSE

Copyright (C) 2008 by A. Radkov.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.8 or, at your option, any later version of Perl 5 you may have available.