Main Page   Namespace List   Class Hierarchy   Alphabetical List   Compound List   Namespace Members   Compound Members   Related Pages  

ObjCryst::ObjRegistry< T > Class Template Reference

Object Registry. More...

List of all members.

Public Methods

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.

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.

const RefinableObjClockGetRegistryClock () 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 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>
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.

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
 

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
 

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 unsigned int    i const
 

Get object i in the registry.

For internal use only.

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

template<class T>
T& ObjCryst::ObjRegistry< T >::GetObj const unsigned int    i
 

Get object i in the registry.

For internal use only.

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


The documentation for this class was generated from the following file:
Generated on Fri Apr 30 08:01:09 2004 for ObjCryst++ by doxygen1.2.18