The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

Template::Filters - defines post-processing filters for template blocks

SYNOPSIS

    [% FILTER html %]
       x < 10 && y != 0
    [% END %]

    [% FILTER format('<!-- %-40s -->') %]
    This will end up formatted, line-by-line,
    as HTML comments...
    [% END %]

    etc...

DESCRIPTION

The 'html' filter converts the characters '<', '>' and '&' to '&lt;', '&gt;' and '&amp', respectively, protecting them from being interpreted as representing HTML tags or entities. The 'html_para' filter converts text into HTML paragraphs <p>....</p>. The 'html_break' filter is similar, but uses <br><br> as a paragraph delimiter.

The 'format' filter takes a format string as a parameter (as per printf()) and formats each line of text accordingly. The 'truncate' filter truncates text at a given length and the 'repeat' filter duplicates text any number of times. The 'remove' filter removes a specified character sequence or Perl regular expression, and the 'replace' filter does the same, allowing a replacement string to be specified.

The 'redirect' and 'into' filters can be used to redirect a text block to another file, or to store it in a named variable, respectively.

See Template for full (and possibly more up-to-date) information on using these filters.

See the module source code for insights on writing additional filter.

AUTHOR

Andy Wardley <cre.canon.co.uk>

REVISION

$Revision: 1.3 $

COPYRIGHT

Copyright (C) 1996-1999 Andy Wardley. All Rights Reserved. Copyright (C) 1998-1999 Canon Research Centre Europe Ltd.

This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

SEE ALSO

Template