Variable::Magic - Associate user-defined magic to variables from Perl.
VERSION
- Version 0.47
+ Version 0.48
SYNOPSIS
use Variable::Magic qw<wizard cast VMG_OP_INFO_NAME>;
straight to the perl magic API. However, only the return value of
the "len" callback currently holds a meaning.
- Each callback can be specified as a code or a string reference, in which
- case the function denoted by the string will be used as the callback.
+ Each callback can be specified as :
+
+ * a code reference, which will be called as a subroutine.
+
+ * a string reference, where the string denotes which subroutine is to
+ be called when magic is triggered. If the subroutine name is not
+ fully qualified, then the current package at the time the magic is
+ invoked will be used instead.
+
+ * a reference to "undef", in which case a no-op magic callback is
+ installed instead of the default one. This may especially be helpful
+ for 'local' magic, where an empty callback prevents magic from being
+ copied during localization.
Note that "free" callbacks are *never* called during global destruction,
as there's no way to ensure that the wizard and the "free" callback
<http://www.profvince.com/perl/cover/Variable-Magic>.
COPYRIGHT & LICENSE
- Copyright 2007,2008,2009,2010,2011 Vincent Pit, all rights reserved.
+ Copyright 2007,2008,2009,2010,2011,2012 Vincent Pit, all rights
+ reserved.
This program is free software; you can redistribute it and/or modify it
under the same terms as Perl itself.