NAME
Template::Plugin::ScalarUtil - Scalar::Util plugin for Template-Toolkit
VERSION
version 1.121160
SYNOPSIS
[% USE ScalarUtil %]
# blessed
[% ScalarUtil.blessed(EXPR) ? 'blessed' : 'not blessed' %]
# dualvar
[% SET dv = ScalarUtil.dualvar( 5, "Hello" ) %]
[% SET num = dv + 7 %]
[% SET string = dv _ " world!" %]
[% num == string.length ? "correct" : "ups" %]
# isvstring
[% ScalarUtil.isvstring(vstring) ? 'is vstring' : 'is not vstring' %]
# looks_like_number
[% ScalarUtil.looks_like_number('Infinity') ? 'number' : 'not number' %]
# openhandle
[% ScalarUtil.openhandle(FH) ? "opened" : "not opened" %]
# refaddr
[% ScalarUtil.refaddr(EXPR) %]
# reftype
[% ScalarUtil.reftype(EXPR) %]
# tainted
[% ScalarUtil.tainted(EXPR) %]DESCRIPTION
Use Scalar::Util functions in your templates.
METHODS
blessed
[%
IF ScalarUtil.blessed(EXPR);
EXPR.method(args);
END;
%]Returns the name of the package if EXPR is a blessed reference.
dualvar
[% SET dv = ScalarUtil.dualvar( num, string ) %]Returns a scalar that has the value num in a numeric context and the value string in a string context.
isvstring
[%
USE vstring = format('%vd');
USE string = format('%s');
IF ScalarUtil.isvstring(EXPR);
vstring(EXPR);
ELSE;
string(EXPR);
END;
%]Returns true if EXPR was coded as vstring;
looks_like_number
[% IF ScalarUtil.looks_like_number(EXPR) %]
[% EXPR %] looks like number
[% END %]Returns true if perl thinks EXPR is a number.
openhandle
[% IF ScalarUtil.openhandle(FH) %]
FH is an opened filehandle
[% END %]Returns FH if it is opened filehandle, undef otherwise.
refaddr
[% ScalarUtil.refaddr(EXPR) %]Returns internal memory address of the EXPR if it is a reference, undef otherwise.
reftype
[% SWITCH ScalarUtil.reftype(EXPR) %]
[% CASE 'ARRAY' %]
[% EXPR.size %]
[% CASE 'HASH' %]
[% EXPR.list.size %]
[% END %]Returns the type of the EXPR if it is a reference, undef otherwise.
tainted
[% IF ScalarUtil.tainted(EXPR) %]
EXPR is tainted
[% END %]Returns true if EXPR is tainted.
NOTES
Please note that following methods were NOT implemented due to the nature of TT's stash.
isweak
readonly
set_prototype
weaken
SEE ALSO
Please see those modules/websites for more information related to this module.
AUTHOR
Alex J. G. Burzyński <ajgb@cpan.org>
COPYRIGHT AND LICENSE
This software is copyright (c) 2012 by Alex J. G. Burzyński <ajgb@cpan.org>.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.