debian man page for kiokudb::liveobjects::scope

KiokuDB::LiveObjects::Scope(3pm)			User Contributed Perl Documentation			  KiokuDB::LiveObjects::Scope(3pm)

NAME
       KiokuDB::LiveObjects::Scope - Scope helper object

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.

perl v5.12.4							    2010-10-11					  KiokuDB::LiveObjects::Scope(3pm)