PSafeDictionaryBase< Coll, Key, Base > Class Template Reference

#include <safecoll.h>

Inheritance diagram for PSafeDictionaryBase< Coll, Key, Base >:

List of all members.

Public Member Functions
Operations
virtual void	SetAt (const Key &key, Base *obj)
virtual BOOL	RemoveAt (const Key &key)
virtual BOOL	Contains (const Key &key)
virtual PSafePtr< Base >	GetAt (PINDEX idx, PSafetyMode mode=PSafeReadWrite)
virtual PSafePtr< Base >	FindWithLock (const Key &key, PSafetyMode mode=PSafeReadWrite)

---

Detailed Description

template<class Coll, class Key, class Base>
class PSafeDictionaryBase< Coll, Key, Base >

This class defines a thread-safe dictionary of objects.

This is part of a set of classes to solve the general problem of a collection (eg a PList or PDictionary) of objects that needs to be a made thread safe. Any thread can add, read, write or remove an object with both the object and the database of objects itself kept thread safe.

See the PSafeObject class for more details. Especially in regard to enumeration of collections.

---

Constructor & Destructor Documentation

template<class Coll, class Key, class Base>

PSafeDictionaryBase< Coll, Key, Base >::PSafeDictionaryBase

(

)

[inline]

Create a safe dictionary wrapper around the real collection.

template<class Coll, class Key, class Base>

PSafeDictionaryBase< Coll, Key, Base >::PSafeDictionaryBase

(

)

[inline]

Create a safe dictionary wrapper around the real collection.

---

Member Function Documentation

template<class Coll, class Key, class Base>

virtual void PSafeDictionaryBase< Coll, Key, Base >::SetAt	(	const Key &	key,
		Base *	obj
	)			[inline, virtual]

Add an object to the collection. This uses the PCollection::Append() function to add the object to the collection, with full mutual exclusion locking on the collection.

template<class Coll, class Key, class Base>

virtual BOOL PSafeDictionaryBase< Coll, Key, Base >::RemoveAt

(

const Key &

key

)

[inline, virtual]

Remove an object to the collection. This function removes the object from the collection itself, but does not actually delete the object. It simply moves the object to a list of objects to be garbage collected at a later time.

As for Append() full mutual exclusion locking on the collection itself is maintained.

Parameters:

key	Key to fund object to delete

template<class Coll, class Key, class Base>

virtual BOOL PSafeDictionaryBase< Coll, Key, Base >::Contains

(

const Key &

key

)

[inline, virtual]

Determine of the dictionary contains an entry for the key.

template<class Coll, class Key, class Base>

virtual PSafePtr<Base> PSafeDictionaryBase< Coll, Key, Base >::GetAt	(	PINDEX	idx,
		PSafetyMode	mode = PSafeReadWrite
	)			[inline, virtual]

Get the instance in the collection of the index. The returned safe pointer will increment the reference count on the PSafeObject and lock to the object in the mode specified. The lock will remain until the PSafePtr goes out of scope.

template<class Coll, class Key, class Base>

virtual PSafePtr<Base> PSafeDictionaryBase< Coll, Key, Base >::FindWithLock	(	const Key &	key,
		PSafetyMode	mode = PSafeReadWrite
	)			[inline, virtual]

Find the instance in the collection of an object with the same value. The returned safe pointer will increment the reference count on the PSafeObject and lock to the object in the mode specified. The lock will remain until the PSafePtr goes out of scope.

---

The documentation for this class was generated from the following file:

• safecoll.h

---