X-Git-Url: http://git.vpit.fr/?a=blobdiff_plain;f=README;h=2163a42b6db912538bc41006ca0540cd72bc58d9;hb=d4aad958fea3256ea8842c783566e3b89e546b6d;hp=bc02476f9e3f05f259c232398cd3f16c35f6deb9;hpb=e9cf334a2e89126f89a80ad04241b0a83ed913b2;p=perl%2Fmodules%2Fautovivification.git diff --git a/README b/README index bc02476..2163a42 100644 --- a/README +++ b/README @@ -2,7 +2,7 @@ NAME autovivification - Lexically disable autovivification. VERSION - Version 0.01 + Version 0.03 SYNOPSIS no autovivification; @@ -40,8 +40,11 @@ METHODS * 'fetch' Turn off autovivification for rvalue dereferencing expressions, such - as "$value = $hashref->{key}[$idx]{$field}". "undef" is returned - when the expression would have autovivified. + as "$value = $hashref->{key}[$idx]{$field}", "keys + %{$hashref->{key}}" or "values %{$hashref->{key}}". When the + expression would have autovivified, "undef" is returned for a plain + fetch, while "keys" and "values" return 0 in scalar context and the + empty list in list context. * 'exists' @@ -59,8 +62,9 @@ METHODS * 'store' Turn off autovivification for lvalue dereferencing expressions, such - as "$hashref->{key}[$idx]{$field} = $value". An exception is thrown - if vivification is needed to store the value, which means that + as "$hashref->{key}[$idx]{$field} = $value" or "for + ($hashref->{key}[$idx]{$field}) { ... }". An exception is thrown if + vivification is needed to store the value, which means that effectively you can only assign to levels that are already defined (in the example, this would require "$hashref->{key}[$idx]" to already be a hash reference).