ObjectList is one of the basic Gaudi container classes capable of being registered in Data Stores. More...

#include <GaudiKernel/ObjectList.h>

Inheritance diagram for ObjectList< TYPE >:

Collaboration diagram for ObjectList< TYPE >:

[legend]

Public Types
typedef TYPE	contained_type

typedef std::list< TYPE * >::value_type	value_type

typedef std::list< TYPE * >::reference	reference

typedef std::list< TYPE * >::const_reference	const_reference

typedef std::list< TYPE * >::iterator	iterator

typedef std::list< TYPE * >::const_iterator	const_iterator

typedef std::list< TYPE * >::reverse_iterator	reverse_iterator

typedef std::list< TYPE * >::const_reverse_iterator	const_reverse_iterator

typedef std::vector< TYPE * >::pointer	pointer

typedef std::vector< TYPE * >::const_pointer	const_pointer

Public Types inherited from ObjectContainerBase
typedef size_t	size_type
	size_type, to conform the STL container interface More...

Public Member Functions
	ObjectList ()=default
	Constructors. More...

	ObjectList (const ObjectList< TYPE > &)=delete

ObjectList &	operator= (const ObjectList< TYPE > &)=delete

	~ObjectList () override
	Destructor. More...

const CLID &	clID () const override
	Retrieve pointer to class definition structure. More...

ObjectList< TYPE >::iterator	begin ()
	Return an iterator pointing to the beginning of the container. More...

ObjectList< TYPE >::const_iterator	begin () const
	Return a const_iterator pointing to the beginning of the container. More...

ObjectList< TYPE >::iterator	end ()
	Return an iterator pointing to the end of the container. More...

ObjectList< TYPE >::const_iterator	end () const
	Return a const_iterator pointing to the end of the container. More...

ObjectList< TYPE >::reverse_iterator	rbegin ()
	Return a reverse_iterator pointing to the beginning of the reversed container. More...

ObjectList< TYPE >::const_reverse_iterator	rbegin () const
	Return a const_reverse_iterator pointing to the beginning of the reversed container. More...

ObjectList< TYPE >::reverse_iterator	rend ()
	Return a reverse_iterator pointing to the end of the reversed container. More...

ObjectList< TYPE >::const_reverse_iterator	rend () const
	Return a const_reverse_iterator pointing to the end of the reversed container. More...

ObjectList< TYPE >::size_type	size () const
	Return the size of the container Size means the number of objects stored in the container, independently on the amount of information stored in each object. More...

ObjectList< TYPE >::size_type	numberOfObjects () const override
	The same as size(), return number of objects in the container. More...

ObjectList< TYPE >::size_type	max_size () const
	Return the largest possible size of the container. More...

bool	empty () const
	Return true if the size of the container is 0. More...

ObjectList< TYPE >::reference	front ()
	Return reference to the first element. More...

ObjectList< TYPE >::const_reference	front () const
	Return const_reference to the first element. More...

ObjectList< TYPE >::reference	back ()
	Return reference to the last element. More...

ObjectList< TYPE >::const_reference	back () const
	Return const_reference to the last element. More...

void	push_back (typename ObjectList< TYPE >::const_reference value)
	push_back = append = insert a new element at the end of the container More...

long	add (ContainedObject *pObject) override
	Add an object to the container. More...

void	pop_back ()
	pop_back = remove the last element from the container The removed object will be deleted (see the method release) More...

long	remove (ContainedObject *value) override
	Release object from the container (the pointer will be removed from the container, but the object itself will remain alive) (see the method pop_back) More...

ObjectList< TYPE >::iterator	insert (typename ObjectList< TYPE >::iterator position, typename ObjectList< TYPE >::const_reference value)
	Insert "value" before "position". More...

void	erase (typename ObjectList< TYPE >::iterator position)
	Erase the object at "position" from the container. The removed object will be deleted. More...

void	erase (typename ObjectList< TYPE >::iterator first, typename ObjectList< TYPE >::iterator last)
	Erase the range [first, last) from the container. The removed object will be deleted. More...

void	clear ()
	Clear the entire content of the container and delete all contained objects. More...

long	index (const ContainedObject *obj) const override
	Return distance of a given object from the beginning of its container It corresponds to the "index" ( from 0 to size()-1 ) If "obj" not fount, return -1. More...

const ContainedObject *	containedObject (long dist) const override
	Return const pointer to an object of a given distance. More...

ContainedObject *	containedObject (long dist) override
	Return const pointer to an object of a given distance. More...

std::ostream &	fillStream (std::ostream &s) const override
	Fill the output stream (ASCII) More...

Public Member Functions inherited from DataObject
	DataObject ()
	Standard Constructor. More...

	DataObject (const DataObject &rhs)
	Copy Constructor. More...

DataObject &	operator= (const DataObject &rhs)
	Assignment Operator. More...

	DataObject (DataObject &&rhs)
	Move Constructor. More...

DataObject &	operator= (DataObject &&rhs)
	Move Assignment Operator. More...

virtual	~DataObject ()
	Standard Destructor. More...

virtual unsigned long	addRef ()
	Add reference to object. More...

virtual unsigned long	release ()
	release reference to object More...

const std::string &	name () const
	Retreive DataObject name. It is the name when registered in the store. More...

virtual StatusCode	update ()
	Provide empty placeholder for internal object reconfiguration callback. More...

void	setRegistry (IRegistry *pRegistry)
	Set pointer to Registry. More...

IRegistry *	registry () const
	Get pointer to Registry. More...

LinkManager *	linkMgr () const
	Retrieve Link manager. More...

unsigned char	version () const
	Retrieve version number of this object representation. More...

void	setVersion (unsigned char vsn)
	Set version number of this object representation. More...

unsigned long	refCount () const
	Return the refcount. More...

Static Public Member Functions
static const CLID &	classID ()

Static Public Member Functions inherited from DataObject
static const CLID &	classID ()
	Retrieve reference to class definition structure (static access) More...

Private Attributes
std::list< TYPE * >	m_list
	The STL list. More...

Additional Inherited Members
Protected Member Functions inherited from ObjectContainerBase
	ObjectContainerBase ()=default
	Constructor. More...

	ObjectContainerBase (ObjectContainerBase &&)=default

ObjectContainerBase &	operator= (ObjectContainerBase &&)=default

	~ObjectContainerBase () override=default

Detailed Description

template<class TYPE>
class ObjectList< TYPE >

ObjectList is one of the basic Gaudi container classes capable of being registered in Data Stores.

It is based on Standard Library (STL) std::list (see STL Programmer's Guide) ObjectList has all functions of the std::list interface,

Each object is allowed to belong into a single container only. After inserting the object into the container, it takes over all responsibilities for the object. E.g. erasing the object from its container causes removing the object's pointer from the container and deleting the object itself.

Author: Pavel Binko; Pere Mato

Date: 19/10/1999, 30/11/2000

Definition at line 24 of file ContainedObject.h.

Member Typedef Documentation

◆ const_iterator

template<class TYPE>

typedef std::list<TYPE*>::const_iterator ObjectList< TYPE >::const_iterator

Definition at line 55 of file ObjectList.h.

◆ const_pointer

template<class TYPE>

typedef std::vector<TYPE*>::const_pointer ObjectList< TYPE >::const_pointer

Definition at line 65 of file ObjectList.h.

◆ const_reference

template<class TYPE>

typedef std::list<TYPE*>::const_reference ObjectList< TYPE >::const_reference

Definition at line 52 of file ObjectList.h.

◆ const_reverse_iterator

template<class TYPE>

typedef std::list<TYPE*>::const_reverse_iterator ObjectList< TYPE >::const_reverse_iterator

Definition at line 58 of file ObjectList.h.

◆ contained_type

template<class TYPE>

typedef TYPE ObjectList< TYPE >::contained_type

Definition at line 48 of file ObjectList.h.

◆ iterator

template<class TYPE>

typedef std::list<TYPE*>::iterator ObjectList< TYPE >::iterator

Definition at line 54 of file ObjectList.h.

◆ pointer

template<class TYPE>

typedef std::vector<TYPE*>::pointer ObjectList< TYPE >::pointer

Definition at line 64 of file ObjectList.h.

◆ reference

template<class TYPE>

typedef std::list<TYPE*>::reference ObjectList< TYPE >::reference

Definition at line 51 of file ObjectList.h.

◆ reverse_iterator

template<class TYPE>

typedef std::list<TYPE*>::reverse_iterator ObjectList< TYPE >::reverse_iterator

Definition at line 57 of file ObjectList.h.

◆ value_type

template<class TYPE>

typedef std::list<TYPE*>::value_type ObjectList< TYPE >::value_type

Definition at line 49 of file ObjectList.h.

Constructor & Destructor Documentation

◆ ObjectList() [1/2]

template<class TYPE>

ObjectList< TYPE >::ObjectList ( )

default

Constructors.

◆ ObjectList() [2/2]

template<class TYPE>

ObjectList< TYPE >::ObjectList ( const ObjectList< TYPE > & )

delete

◆ ~ObjectList()

template<class TYPE>

ObjectList< TYPE >::~ObjectList ( )

inlineoverride

Destructor.

Definition at line 76 of file ObjectList.h.

76 { clear(); }

ObjectList::clear

void clear()

Clear the entire content of the container and delete all contained objects.

Definition: ObjectList.h:220

Member Function Documentation

◆ add()

template<class TYPE>

long ObjectList< TYPE >::add ( ContainedObject * pObject )

inlineoverridevirtual

Add an object to the container.

Implements ObjectContainerBase.

Definition at line 146 of file ObjectList.h.

                                                 {
     try {
       auto ptr = dynamic_cast<typename ObjectList<TYPE>::value_type>( pObject );
       if ( ptr ) {
         push_back( ptr );
         return m_list.size() - 1;
       }
     } catch ( ... ) {}
     return -1;
   }

◆ back() [1/2]

template<class TYPE>

ObjectList<TYPE>::reference ObjectList< TYPE >::back ( )

inline

Return reference to the last element.

Definition at line 133 of file ObjectList.h.

133 { return m_list.back(); }

ObjectList::m_list

std::list< TYPE * > m_list

The STL list.

Definition: ObjectList.h:255

std::list::back

T back(T... args)

◆ back() [2/2]

template<class TYPE>

ObjectList<TYPE>::const_reference ObjectList< TYPE >::back ( ) const

inline

Return const_reference to the last element.

Definition at line 136 of file ObjectList.h.

136 { return m_list.back(); }

ObjectList::m_list

std::list< TYPE * > m_list

The STL list.

Definition: ObjectList.h:255

std::list::back

T back(T... args)

◆ begin() [1/2]

template<class TYPE>

ObjectList<TYPE>::iterator ObjectList< TYPE >::begin ( )

inline

Return an iterator pointing to the beginning of the container.

Definition at line 86 of file ObjectList.h.

86 { return m_list.begin(); }

ObjectList::m_list

std::list< TYPE * > m_list

The STL list.

Definition: ObjectList.h:255

std::list::begin

T begin(T... args)

◆ begin() [2/2]

template<class TYPE>

ObjectList<TYPE>::const_iterator ObjectList< TYPE >::begin ( ) const

inline

Return a const_iterator pointing to the beginning of the container.

Definition at line 89 of file ObjectList.h.

89 { return m_list.begin(); }

ObjectList::m_list

std::list< TYPE * > m_list

The STL list.

Definition: ObjectList.h:255

std::list::begin

T begin(T... args)

◆ classID()

template<class TYPE>

static const CLID& ObjectList< TYPE >::classID ( )

inlinestatic

Definition at line 80 of file ObjectList.h.

                                {
     static CLID clid = TYPE::classID() + CLID_ObjectList;
     return clid;
   }

◆ clear()

template<class TYPE>

void ObjectList< TYPE >::clear ( )

inline

Clear the entire content of the container and delete all contained objects.

Definition at line 220 of file ObjectList.h.

220 { erase( begin(), end() ); }

ObjectList::begin

ObjectList< TYPE >::iterator begin()

Return an iterator pointing to the beginning of the container.

Definition: ObjectList.h:86

ObjectList::erase

void erase(typename ObjectList< TYPE >::iterator position)

Erase the object at "position" from the container. The removed object will be deleted.

Definition: ObjectList.h:196

ObjectList::end

ObjectList< TYPE >::iterator end()

Return an iterator pointing to the end of the container.

Definition: ObjectList.h:92

◆ clID()

template<class TYPE>

const CLID& ObjectList< TYPE >::clID ( ) const

inlineoverridevirtual

Retrieve pointer to class definition structure.

Reimplemented from DataObject.

Definition at line 79 of file ObjectList.h.

79 { return ObjectList<TYPE>::classID(); }

ObjectList::classID

static const CLID & classID()

Definition: ObjectList.h:80

◆ containedObject() [1/2]

template<class TYPE>

const ContainedObject* ObjectList< TYPE >::containedObject ( long dist ) const

inlineoverridevirtual

Return const pointer to an object of a given distance.

Implements ObjectContainerBase.

Definition at line 230 of file ObjectList.h.

                                                                      {
     return dist < size() ? *std::next( begin(), dist ) : nullptr;
   }

◆ containedObject() [2/2]

template<class TYPE>

ContainedObject* ObjectList< TYPE >::containedObject ( long dist )

inlineoverridevirtual

Return const pointer to an object of a given distance.

Implements ObjectContainerBase.

Definition at line 234 of file ObjectList.h.

                                                          {
     return dist < size() ? *std::next( begin(), dist ) : nullptr;
   }

◆ empty()

template<class TYPE>

bool ObjectList< TYPE >::empty ( ) const

inline

Return true if the size of the container is 0.

Definition at line 124 of file ObjectList.h.

124 { return m_list.empty(); }

std::list::empty

T empty(T... args)

ObjectList::m_list

std::list< TYPE * > m_list

The STL list.

Definition: ObjectList.h:255

◆ end() [1/2]

template<class TYPE>

ObjectList<TYPE>::iterator ObjectList< TYPE >::end ( )

inline

Return an iterator pointing to the end of the container.

Definition at line 92 of file ObjectList.h.

92 { return m_list.end(); }

std::list::end

T end(T... args)

ObjectList::m_list

std::list< TYPE * > m_list

The STL list.

Definition: ObjectList.h:255

◆ end() [2/2]

template<class TYPE>

ObjectList<TYPE>::const_iterator ObjectList< TYPE >::end ( ) const

inline

Return a const_iterator pointing to the end of the container.

Definition at line 95 of file ObjectList.h.

95 { return m_list.end(); }

std::list::end

T end(T... args)

ObjectList::m_list

std::list< TYPE * > m_list

The STL list.

Definition: ObjectList.h:255

◆ erase() [1/2]

template<class TYPE>

void ObjectList< TYPE >::erase ( typename ObjectList< TYPE >::iterator position )

inline

Erase the object at "position" from the container. The removed object will be deleted.

Definition at line 196 of file ObjectList.h.

                                                            {
     if ( ( *position )->parent() ) {
       // Set the back pointer to 0 to avoid repetitional searching
       // for the object in the container, and deleting the object
       ( *position )->setParent( nullptr );
       delete *position;
     }
     // Removing from the container itself
     m_list.erase( position );
   }

◆ erase() [2/2]

template<class TYPE>

void ObjectList< TYPE >::erase	(	typename ObjectList< TYPE >::iterator	first,
		typename ObjectList< TYPE >::iterator	last
	)

inline

Erase the range [first, last) from the container. The removed object will be deleted.

Definition at line 208 of file ObjectList.h.

                                                                                                 {
     for ( auto iter = first; iter != last; ++iter ) {
       // Set the back pointer to 0 to avoid repetitional searching
       // for the object in the container, and deleting the object
       ( *iter )->setParent( nullptr );
       delete *iter;
     }
     // Removing from the container itself
     m_list.erase( first, last );
   }

◆ fillStream()

template<class TYPE>

std::ostream& ObjectList< TYPE >::fillStream ( std::ostream & s ) const

inlineoverridevirtual

Fill the output stream (ASCII)

Reimplemented from DataObject.

Definition at line 239 of file ObjectList.h.

                                                          {
     s << "class ObjectList :    size = " << std::setw( 12 ) << size() << "\n";
     // Output the base class
     // ObjectContainerBase::fillStream(s);
     if ( !empty() ) {
       s << "\nContents of the STL list :";
       long count = 0;
       for ( const auto& iter : m_list ) {
         s << "\nIndex " << std::setw( 12 ) << count++ << " of object of type " << *iter;
       }
     }
     return s;
   }

◆ front() [1/2]

template<class TYPE>

ObjectList<TYPE>::reference ObjectList< TYPE >::front ( )

inline

Return reference to the first element.

Definition at line 127 of file ObjectList.h.

127 { return m_list.front(); }

std::list::front

T front(T... args)

ObjectList::m_list

std::list< TYPE * > m_list

The STL list.

Definition: ObjectList.h:255

◆ front() [2/2]

template<class TYPE>

ObjectList<TYPE>::const_reference ObjectList< TYPE >::front ( ) const

inline

Return const_reference to the first element.

Definition at line 130 of file ObjectList.h.

130 { return m_list.front(); }

std::list::front

T front(T... args)

ObjectList::m_list

std::list< TYPE * > m_list

The STL list.

Definition: ObjectList.h:255

◆ index()

template<class TYPE>

long ObjectList< TYPE >::index ( const ContainedObject * obj ) const

inlineoverridevirtual

Return distance of a given object from the beginning of its container It corresponds to the "index" ( from 0 to size()-1 ) If "obj" not fount, return -1.

Implements ObjectContainerBase.

Definition at line 224 of file ObjectList.h.

                                                           {
     auto i = std::find_if( begin(), end(), [&]( const ContainedObject* o ) { return o == obj; } );
     return i != end() ? std::distance( begin(), i ) : -1;
   }

◆ insert()

template<class TYPE>

ObjectList<TYPE>::iterator ObjectList< TYPE >::insert	(	typename ObjectList< TYPE >::iterator	position,
		typename ObjectList< TYPE >::const_reference	value
	)

inline

Insert "value" before "position".

Definition at line 189 of file ObjectList.h.

                                                                                                {
     value->setParent( this );
     return m_list.insert( position, value );
   }

◆ max_size()

template<class TYPE>

ObjectList<TYPE>::size_type ObjectList< TYPE >::max_size ( ) const

inline

Return the largest possible size of the container.

Definition at line 121 of file ObjectList.h.

121 { return m_list.max_size(); }

ObjectList::m_list

std::list< TYPE * > m_list

The STL list.

Definition: ObjectList.h:255

std::list::max_size

T max_size(T... args)

◆ numberOfObjects()

template<class TYPE>

ObjectList<TYPE>::size_type ObjectList< TYPE >::numberOfObjects ( ) const

inlineoverridevirtual

The same as size(), return number of objects in the container.

Implements ObjectContainerBase.

Definition at line 118 of file ObjectList.h.

118 { return m_list.size(); }

ObjectList::m_list

std::list< TYPE * > m_list

The STL list.

Definition: ObjectList.h:255

std::list::size

T size(T... args)

◆ operator=()

template<class TYPE>

ObjectList& ObjectList< TYPE >::operator= ( const ObjectList< TYPE > & )

delete

◆ pop_back()

template<class TYPE>

void ObjectList< TYPE >::pop_back ( )

inline

pop_back = remove the last element from the container The removed object will be deleted (see the method release)

Definition at line 159 of file ObjectList.h.

                   {
     auto position = m_list.back();
     // Set the back pointer to 0 to avoid repetitional searching
     // for the object in the container, and deleting the object
     position->setParent( nullptr );
     delete position;
     // Removing from the container itself
     m_list.pop_back();
   }

◆ push_back()

template<class TYPE>

void ObjectList< TYPE >::push_back ( typename ObjectList< TYPE >::const_reference value )

inline

push_back = append = insert a new element at the end of the container

Definition at line 139 of file ObjectList.h.

                                                                    {
     if ( value->parent() ) { const_cast<ObjectContainerBase*>( value->parent() )->remove( value ); }
     value->setParent( this );
     m_list.push_back( value );
   }

◆ rbegin() [1/2]

template<class TYPE>

ObjectList<TYPE>::reverse_iterator ObjectList< TYPE >::rbegin ( )

inline

Return a reverse_iterator pointing to the beginning of the reversed container.

Definition at line 99 of file ObjectList.h.

99 { return m_list.rbegin(); }

ObjectList::m_list

std::list< TYPE * > m_list

The STL list.

Definition: ObjectList.h:255

std::list::rbegin

T rbegin(T... args)

◆ rbegin() [2/2]

template<class TYPE>

ObjectList<TYPE>::const_reverse_iterator ObjectList< TYPE >::rbegin ( ) const

inline

Return a const_reverse_iterator pointing to the beginning of the reversed container.

Definition at line 102 of file ObjectList.h.

102 { return m_list.rbegin(); }

ObjectList::m_list

std::list< TYPE * > m_list

The STL list.

Definition: ObjectList.h:255

std::list::rbegin

T rbegin(T... args)

◆ remove()

template<class TYPE>

long ObjectList< TYPE >::remove ( ContainedObject * value )

inlineoverridevirtual

Release object from the container (the pointer will be removed from the container, but the object itself will remain alive) (see the method pop_back)

Implements ObjectContainerBase.

Definition at line 171 of file ObjectList.h.

                                                  {
     // Find the object of value value
     long idx  = 0;
     auto iter = std::find_if( begin(), end(), [&]( const ContainedObject* i ) { return i == value; } );
     if ( iter == end() ) {
       // Object cannot be released from the container,
       // as it is not contained in it
       return -1;
     }
 
     // Set the back pointer to 0 to avoid repetitional searching
     // for the object in the container and deleting the object
     ( *iter )->setParent( nullptr );
     erase( iter );
     return idx;
   }

◆ rend() [1/2]

template<class TYPE>

ObjectList<TYPE>::reverse_iterator ObjectList< TYPE >::rend ( )

inline

Return a reverse_iterator pointing to the end of the reversed container.

Definition at line 105 of file ObjectList.h.

105 { return m_list.rend(); }

std::list::rend

T rend(T... args)

ObjectList::m_list

std::list< TYPE * > m_list

The STL list.

Definition: ObjectList.h:255

◆ rend() [2/2]

template<class TYPE>

ObjectList<TYPE>::const_reverse_iterator ObjectList< TYPE >::rend ( ) const

inline

Return a const_reverse_iterator pointing to the end of the reversed container.

Definition at line 108 of file ObjectList.h.

108 { return m_list.rend(); }

std::list::rend

T rend(T... args)

ObjectList::m_list

std::list< TYPE * > m_list

The STL list.

Definition: ObjectList.h:255

◆ size()

template<class TYPE>

ObjectList<TYPE>::size_type ObjectList< TYPE >::size ( ) const

inline

Return the size of the container Size means the number of objects stored in the container, independently on the amount of information stored in each object.

Definition at line 113 of file ObjectList.h.

                                                   {
     // C++11: std::list::size is constant (pre C++11 it could be linear!)
     return m_list.size();
   }

Member Data Documentation

◆ m_list

template<class TYPE>

std::list<TYPE*> ObjectList< TYPE >::m_list

private

The STL list.

Definition at line 255 of file ObjectList.h.

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

GaudiKernel/GaudiKernel/ContainedObject.h
GaudiKernel/GaudiKernel/ObjectList.h

Public Types

Public Member Functions

Static Public Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

template<class TYPE> class ObjectList< TYPE >

Member Typedef Documentation

◆ const_iterator

◆ const_pointer

◆ const_reference

◆ const_reverse_iterator

◆ contained_type

◆ iterator

◆ pointer

◆ reference

◆ reverse_iterator

◆ value_type

Constructor & Destructor Documentation

◆ ObjectList() [1/2]

◆ ObjectList() [2/2]

◆ ~ObjectList()

Member Function Documentation

◆ add()

◆ back() [1/2]

◆ back() [2/2]

◆ begin() [1/2]

◆ begin() [2/2]

◆ classID()

◆ clear()

◆ clID()

◆ containedObject() [1/2]

◆ containedObject() [2/2]

◆ empty()

◆ end() [1/2]

◆ end() [2/2]

◆ erase() [1/2]

◆ erase() [2/2]

◆ fillStream()

◆ front() [1/2]

◆ front() [2/2]

◆ index()

◆ insert()

◆ max_size()

◆ numberOfObjects()

◆ operator=()

◆ pop_back()

◆ push_back()

◆ rbegin() [1/2]

◆ rbegin() [2/2]

◆ remove()

◆ rend() [1/2]

◆ rend() [2/2]

◆ size()

Member Data Documentation

◆ m_list

template<class TYPE>
class ObjectList< TYPE >