NAME
WeakRef::Auto - Automatically makes references weaken
VERSION
This document describes WeakRef::Auto version 0.01.
SYNOPSIS
use WeakRef::Auto;
autoweaken my $ref; # $ref is always weaken
$ref = \$var; # $ref is weakDESCRIPTION
WeakRef::Auto provides autoweaken(), which keeps references weaken.
FUNCTIONS
autoweaken($var)
Turns $var into auto-weaken variables, and keeps the values weak references.
$var can be an element of hashes or arrayes.
NOTE: the prototype of autoweaken() is "\$". That is, autoweakn($var) means &autoweaken(\$var).
DEPENDENCIES
Perl 5.8.1 or later.
BUGS AND LIMITATIONS
autoweaken() does not work with tied variables, because autoweaken-ness is attached to the variable, not to the value refered by the variable, and tied variables iteract with their objects by values, not variables.
my $x = tie my %hash, 'Tie::StdHash';
autoweaken $hash{foo};
# $hash{foo} seems autoweaken. Really?
# Actually, $hash{foo} is connected to $x->{foo},
# but there is no way to autoweaken($x->{foo}).Patches are welcome.
SEE ALSO
Scalar::Util for a description of weak references.
AUTHOR
Goro Fuji <gfuji(at)cpan.org>.
LICENSE AND COPYRIGHT
Copyright (c) 2008, Goro Fuji <gfuji(at)cpan.org>. Some rights reserved.
This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.