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.

perl v5.34.0                                       2022-05-23                   KiokuDB::LiveObjects::Scope(3pm)