NAME
IPC::Shm::Tied
SYNOPSIS
This class is part of the IPC::Shm implementation. You should not be using it directly, as doing so would confuse the garbage collection routines.
SUPERCLASS
This class is a derivative of IPC::Shm::Segment, which in turn is a derivative of IPC::Shm::Simple.
CONSTRUCTORS
TIEHASH, TIEARRAY, TIESCALAR
This package supports the tie() call.
$this->retie
When an anonymous variable is dereferenced, and in some other circumstances, it has to be tied to a variable so it can be accessed normally.
DESTRUCTOR
$this->DETACH
Called from IPC::Shm::Simple when the last in-process instance of this same segment is being DESTROYed.
TIED REFERENCE RETRIEVAL
$this->tiedref
Retrieves a reference to the object's associated tied variable. Calls retie() when necessary.
$this->tiedref( $reference )
Stores a reference to the object's associated tied variable. This allows retie() to be avoided most of the time.
$this->tiedref_clean
Removes the object's tied reference from the cache.
$this->standin_tiedref( $standin )
Returns a reference to the tied variable, given a standin hash. See IPC::Shm::Segment for more about standins.
$this->reftype( $reftype )
Stores the type of object the associated reference points to. This makes the retie() method possible for anonymous segments.
Valid values are 'HASH', 'ARRAY', and 'SCALAR'.
$this->reftype
Retrieves the reference type stored above.
VALUE CACHE METHODS
$this->vcache
Retrieves the cached copy of the deserializer's last run.
$this->vcache( $newvalue )
Stores a new cached value, discarding the old. The Storable module expects this to be a reference (no raw strings).
$this->vcache_clean
Removes the object's value cache from in-process memory.
$class->EMPTY
Returns a reference to an empty object, compatible with the vcache method above. This is an abstract method and must be implemented by inheriting classes.
SERIALIZE/DESERIALIZE
FRESH
Called by IPC::Shm::Simple->fetch when a new value is actually read in from shared memory. The deserializing step happens here.
$this->flush
Serializes and writes the contents of the value cache to shared memory.