Package::Reaper(3) User Contributed Perl Documentation Package::Reaper(3)NAMEPackage::Reaper - pseudo-garbage-collection for packages
VERSION
version 0.103
SYNOPSIS
use Package::Generator;
use Package::Reaper;
{
my $package = Package::Generator->new_package;
my $reaper = Package::Reaper->new($package);
...
}
# at this point, $package stash has been deleted
DESCRIPTION
This module allows you to create simple objects which, when destroyed,
delete a given package. This lets you approximate lexically scoped
packages.
INTERFACE
new
my $reaper = Package::Reaper->new($package);
This returns the newly generated package reaper. When the reaper goes
out of scope and is garbage collected, it will delete the symbol table
entry for the package.
package
my $package = $reaper->package;
This method returns the package which will be reaped.
is_armed
if ($reaper->is_armed) { ... }
This method returns true if the reaper is armed and false otherwise.
Reapers always start out armed. A disarmed reaper will not actually
reap when destroyed.
disarm
$reaper->disarm;
This method disarms the reaper, so that it will not reap the package
when it is destoryed.
arm
$reaper->arm;
This method arms the reaper, so that it will reap its package when it
is destroyed. By default, new reapers are armed.
AUTHOR
Ricardo SIGNES, "<rjbs@cpan.org>"
BUGS
Please report any bugs or feature requests to
"bug-package-generator@rt.cpan.org", or through the web interface at
<http://rt.cpan.org>. I will be notified, and then you'll
automatically be notified of progress on your bug as I make changes.
COPYRIGHT
Copyright 2006 Ricardo Signes, all rights reserved.
This program is free software; you can redistribute it and/or modify it
under the same terms as Perl itself.
perl v5.14.2 2009-07-09 Package::Reaper(3)
