ObjCryst::ObjRegistry< T > Class Template Reference

Object Registry. More...

List of all members.

Public Member Functions
	ObjRegistry (const string &name)
void	Register (T &obj)
	Register a new object. Already registered objects are skipped.
void	DeRegister (T &obj)
	De-register an object.
void	DeRegister (const string &objName)
	De-register an object from its name.
void	DeRegisterAll ()
	De-register all objects from the list.
void	DeleteAll ()
	Delete all objects in the registry.. Use with caution !!
T &	GetObj (const unsigned int i)
	Get object #i in the registry.
const T &	GetObj (const unsigned int i) const
	Get object #i in the registry.
T &	GetObj (const string &objName)
	Get an object from its name in the registry.
const T &	GetObj (const string &objName) const
	Get an object from its name in the registry.
T &	GetObj (const string &objName, const string &className)
	Get an object from its name in the registry.
const T &	GetObj (const string &objName, const string &className) const
	Get an object from its name in the registry.
long	GetNb () const
	Get the index of an object in the registry, from its name Warning: it can change if an object is removed from the registry.
void	Print () const
void	SetName (const string &)
const string &	GetName () const
long	Find (const string &objName) const
	Find the number of an object in the registry from its name (slow !) The search starts at the end of the registry.
long	Find (const string &objName, const string &className, const bool nothrow=false) const
	Find the number of an object in the registry from its name (slow !) The search starts at the end of the registry.
long	Find (const T &obj) const
	Find the number of an object in the registry The search starts at the end of the registry.
long	Find (const T *pobj) const
	Find the number of an object in the registry The search starts at the end of the registry.
const RefinableObjClock &	GetRegistryClock () const
	Last time an object was added or removed from the registry.

Private Attributes
vector< T * >	mvpRegistry
	The registry of objects.
string	mName
	Name of this registry.
RefinableObjClock	mListClock
	Last time an object was added or removed.

---

Detailed Description

template<class T>
class ObjCryst::ObjRegistry< T >

Object Registry.

This class is used to keep a list of all object of a given class at the global level, or inside another object. This is primarily aimed for the derivative of the RefinableObj class but it can be used for any class that has GetName() and GetClassName() function. This class now uses a vector<> approach from the STL.

Warning:

the order of the objects in the registry can change (every time an object is de-registered).

Todo:

(?) create two derived classes with the same interface, one which is a const registry (the 'client' registry for RefinableObj), and one which has a non-const access to the registered objects (the 'sub-objects' in RefinableObj).

---

Member Function Documentation

template<class T>

long ObjCryst::ObjRegistry< T >::Find

(

const string &

objName

)

const

Find the number of an object in the registry from its name (slow !) The search starts at the end of the registry.

template<class T>

long ObjCryst::ObjRegistry< T >::Find	(	const string &	objName,
		const string &	className,
		const bool	nothrow = false
	)		const

Find the number of an object in the registry from its name (slow !) The search starts at the end of the registry.

Also check the class of the object (inheritance...). use nothrow=true to avoid having an exception thrown if no object is found (instead the index returned will be -1)

template<class T>

long ObjCryst::ObjRegistry< T >::Find

(

const T &

obj

)

const

Find the number of an object in the registry The search starts at the end of the registry.

template<class T>

long ObjCryst::ObjRegistry< T >::Find

(

const T *

pobj

)

const

Find the number of an object in the registry The search starts at the end of the registry.

template<class T>

T& ObjCryst::ObjRegistry< T >::GetObj

(

const unsigned int

i

)

Get object #i in the registry.

Use with caution. The order of the objects changes as objects are added and removed.

template<class T>

const T& ObjCryst::ObjRegistry< T >::GetObj

(

const unsigned int

i

)

const

Get object #i in the registry.

Use with caution. The order of the objects changes as objects are added and removed.

template<class T>

T& ObjCryst::ObjRegistry< T >::GetObj

(

const string &

objName

)

Get an object from its name in the registry.

The search starts at the end of the registry.

template<class T>

const T& ObjCryst::ObjRegistry< T >::GetObj

(

const string &

objName

)

const

Get an object from its name in the registry.

The search starts at the end of the registry.

template<class T>

T& ObjCryst::ObjRegistry< T >::GetObj	(	const string &	objName,
		const string &	className
	)

Get an object from its name in the registry.

The search starts at the end of the registry. Also check the class of the object.

template<class T>

const T& ObjCryst::ObjRegistry< T >::GetObj	(	const string &	objName,
		const string &	className
	)		const

Get an object from its name in the registry.

The search starts at the end of the registry. Also check the class of the object.

---

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

• RefinableObj.h