NAME Template::Plugin::StringDump - String::Dump plugin for TT VERSION This document describes Template::Plugin::StringDump version 0.03. SYNOPSIS Template: [% USE StringDump %] [% SET msg = 'Ĝis! ☺' %] hex: [% msg | dump %] dec: [% msg | dump('dec') %] oct: [% msg | dump('oct') %] bin: [% msg | dump('bin') %] names: [% msg | dump('names') %] Output: hex: 11C 69 73 21 20 263A dec: 284 105 115 33 32 9786 oct: 434 151 163 41 40 23072 bin: 100011100 1101001 1110011 100001 100000 10011000111010 names: LATIN CAPITAL LETTER G WITH CIRCUMFLEX, LATIN SMALL LETTER I, LATIN SMALL LETTER S, EXCLAMATION MARK, SPACE, WHITE SMILING FACE The output has been manually split into multiple lines for the layout of this document. DESCRIPTION This Template::Toolkit plugin adds the "dump" filter, which dumps strings of characters or bytes for display and debugging. This filter is a simple wrapper around the "dumpstr" function from the String::Dump module. The filter takes the "dumpstr" mode as an optional argument, defaulting to "hex". See String::Dump for details. The filter name "dump" was selected instead of "dumpstr" because filters only work on strings, so the name would be repetitive. It also doesn't compete with other TT plugins like Template::Plugin::Dump or Template::Plugin::Dumper because they need to function on data structures, as opposed to strings, so they don't provide filters. AUTHOR Nick Patch COPYRIGHT AND LICENSE Copyright 2011 Nick Patch This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.