Revision history for Variable-Magic
+0.37 2009-08-25 15:25 UTC
+ + Add : The new constant VMG_FORKSAFE can be tested to know whether the
+ module will behave nicely when fork()ing. It's currently always
+ true except on Windows where you need perl 5.10.1 for it to be
+ true.
+ + Doc : Nits and clarifications.
+
0.36 2009-07-05 16:30 UTC
+ Chg : getdata() now returns an empty list when no magic is present.
It used to return undef but did not croak as stated in the doc.
--- #YAML:1.0
name: Variable-Magic
-version: 0.36
+version: 0.37
abstract: Associate user-defined magic to variables from Perl.
author:
- Vincent Pit <perl@profvince.com>
ExtUtils::MakeMaker: 0
Test::More: 0
requires:
+ base: 0
Carp: 0
Exporter: 0
perl: 5.008
directory:
- t
- inc
-generated_by: ExtUtils::MakeMaker version 6.52
+generated_by: ExtUtils::MakeMaker version 6.54
meta-spec:
url: http://module-build.sourceforge.net/META-spec-v1.4.html
version: 1.4
Variable::Magic - Associate user-defined magic to variables from Perl.
VERSION
- Version 0.36
+ Version 0.37
SYNOPSIS
use Variable::Magic qw/wizard cast VMG_OP_INFO_NAME/;
* "get"
- This magic is invoked when the variable is evaluated (does not
- include array/hash subscripts and slices).
+ This magic is invoked when the variable is evaluated. It is never
+ called for arrays and hashes.
* "set"
- This one is triggered each time the value of the variable changes
- (includes array/hash subscripts and slices).
+ This one is triggered each time the value of the variable changes.
+ It is called for array subscripts and slices, but never for hashes.
* "len"
$_[2] is an alias to the current key. Nothing prevents you
from changing it, but be aware that there lurk dangerous
- side effects. For example, it may righteously be readonly if
+ side effects. For example, it may rightfully be readonly if
the key was a bareword. You can get a copy instead by
passing "copy_key => 1" to "wizard", which allows you to
safely assign to $_[2] in order to e.g. redirect the action
True iff this module could have been built with thread-safety features
enabled.
+ "VMG_FORKSAFE"
+ True iff this module could have been built with fork-safety features
+ enabled. This will always be true except on Windows where it's false for
+ perl 5.10.0 and below .
+
"VMG_OP_INFO_NAME"
Value to pass with "op_info" to get the current op name in the magic
callbacks.