NAME¶
KiokuDB::LiveObjects::Scope - Scope helper object
VERSION¶
version 0.57
SYNOPSIS¶
{
my $scope = $dir->new_scope;
... do work on $dir ...
}
DESCRIPTION¶
Live object scopes exist in order to ensure objects don't die too soon if the
only other references to them are weak.
When scopes are destroyed the refcounts of the objects they refer to go down,
and the parent scope is replaced in the live object set.
METHODS¶
- push
- Adds objects or entries, increasing their reference count.
- clear
- Clears the objects from the scope object.
- detach
- Marks this scope as no longer the "current" live object scope,
if it is the current one.
This allows keeping branching of scopes, which can be useful under long
running applications.
- remove
- Effectively kills the scope by clearing it and removing it from the live
object set.
AUTHOR¶
Yuval Kogman <nothingmuch@woobling.org>
COPYRIGHT AND LICENSE¶
This software is copyright (c) 2014 by Yuval Kogman, Infinity Interactive.
This is free software; you can redistribute it and/or modify it under the same
terms as the Perl 5 programming language system itself.