X-Git-Url: http://git.vpit.fr/?a=blobdiff_plain;f=README;h=476e5a3eeb6fbad81e150537655f74ae892a277e;hb=5b519e2dbddefbc9195f6a7cc49db883d08fa8d8;hp=03cda6c4d8172f1d6043e6857465f34c434f427c;hpb=c9093dd650fe5e0229e16db9a60f521ec4046552;p=perl%2Fmodules%2FVariable-Magic.git diff --git a/README b/README index 03cda6c..476e5a3 100644 --- a/README +++ b/README @@ -2,7 +2,7 @@ NAME Variable::Magic - Associate user-defined magic to variables from Perl. VERSION - Version 0.28 + Version 0.29 SYNOPSIS use Variable::Magic qw/wizard cast dispell/; @@ -249,20 +249,21 @@ FUNCTIONS (or "undef" when no private data constructor was supplied). Other arguments are specific to the magic hooked : - - "len" + * "len" - When the variable is an array, $_[2] contains the normal - length. The callback is also expected to return the new - scalar or array length. + When the variable is an array or a scalar, $_[2] contains + the non-magical length. The callback can return the new + scalar or array length to use, or "undef" to default to the + normal length. - - "copy" + * "copy" $_[2] is a either a copy or an alias of the current key, which means that it is useless to try to change or cast magic on it. $_[3] is an alias to the current element (i.e. the value). - - "fetch", "store", "exists" and "delete" + * "fetch", "store", "exists" and "delete" $_[2] is an alias to the current key. Nothing prevents you from changing it, but be aware that there lurk dangerous @@ -356,7 +357,7 @@ CAVEATS first. DEPENDENCIES - perl 5.7.3. + perl 5.8. Carp (standard since perl 5), XSLoader (standard since perl 5.006).