The Gaudi Framework  master (37c0b60a)
SmartRefVector< TYPE > Class Template Reference

Kernel objects: SmartRefVector. More...

#include </builds/gaudi/Gaudi/GaudiKernel/include/GaudiKernel/SmartRefVector.h>

Inheritance diagram for SmartRefVector< TYPE >:
Collaboration diagram for SmartRefVector< TYPE >:

Public Member Functions

 SmartRefVector ()
 Standard Constructor. More...
 
template<class ITERATOR >
 SmartRefVector (ITERATOR first, ITERATOR last)
 templated Constructor More...
 
 SmartRefVector (const SmartRefVector &copy)
 Copy Constructor. More...
 
SmartRefVector< TYPE > & operator() (ContainedObject *pObj)
 Standard destructor. More...
 
const SmartRefVector< TYPE > & operator() (const ContainedObject *pObj) const
 operator() const: assigns parent object for serialisation More...
 
SmartRefVector< TYPE > & operator() (DataObject *pObj)
 operator(): assigns parent object for serialisation More...
 
const SmartRefVector< TYPE > & operator() (const DataObject *pObj) const
 operator() const: assigns parent object for serialisation More...
 
SmartRefVector< TYPE > & operator= (const SmartRefVector< TYPE > &copy)
 Assignment. More...
 
const std::type_infotype () const
 Access to embedded type. More...
 
StreamBufferreadRefs (StreamBuffer &s)
 Helper to read references. More...
 
StreamBufferwriteRefs (StreamBuffer &s) const
 Helper to write references. More...
 
- Public Member Functions inherited from std::vector< SmartRef< TYPE > >
SmartRef< TYPE > push_back (SmartRef< TYPE > ... args)
 
SmartRef< TYPE > crbegin (SmartRef< TYPE > ... args)
 
SmartRef< TYPE > erase (SmartRef< TYPE > ... args)
 
SmartRef< TYPE > data (SmartRef< TYPE > ... args)
 
SmartRef< TYPE > insert (SmartRef< TYPE > ... args)
 
SmartRef< TYPE > pop_back (SmartRef< TYPE > ... args)
 
SmartRef< TYPE > shrink_to_fit (SmartRef< TYPE > ... args)
 
SmartRef< TYPE > back (SmartRef< TYPE > ... args)
 
SmartRef< TYPE > end (SmartRef< TYPE > ... args)
 
SmartRef< TYPE > resize (SmartRef< TYPE > ... args)
 
SmartRef< TYPE > emplace_back (SmartRef< TYPE > ... args)
 
SmartRef< TYPE > size (SmartRef< TYPE > ... args)
 
SmartRef< TYPE > cbegin (SmartRef< TYPE > ... args)
 
SmartRef< TYPE > front (SmartRef< TYPE > ... args)
 
SmartRef< TYPE > ~vector (SmartRef< TYPE > ... args)
 
SmartRef< TYPE > rbegin (SmartRef< TYPE > ... args)
 
SmartRef< TYPE > crend (SmartRef< TYPE > ... args)
 
SmartRef< TYPE > assign (SmartRef< TYPE > ... args)
 
SmartRef< TYPE > operator= (SmartRef< TYPE > ... args)
 
SmartRef< TYPE > vector (SmartRef< TYPE > ... args)
 
SmartRef< TYPE > reserve (SmartRef< TYPE > ... args)
 
SmartRef< TYPE > capacity (SmartRef< TYPE > ... args)
 
SmartRef< TYPE > empty (SmartRef< TYPE > ... args)
 
SmartRef< TYPE > cend (SmartRef< TYPE > ... args)
 
SmartRef< TYPE > swap (SmartRef< TYPE > ... args)
 
SmartRef< TYPE > max_size (SmartRef< TYPE > ... args)
 
SmartRef< TYPE > rend (SmartRef< TYPE > ... args)
 
SmartRef< TYPE > get_allocator (SmartRef< TYPE > ... args)
 
SmartRef< TYPE > clear (SmartRef< TYPE > ... args)
 
SmartRef< TYPE > at (SmartRef< TYPE > ... args)
 
SmartRef< TYPE > emplace (SmartRef< TYPE > ... args)
 
SmartRef< TYPE > operator[] (SmartRef< TYPE > ... args)
 
SmartRef< TYPE > begin (SmartRef< TYPE > ... args)
 

Protected Types

typedef SmartRef< TYPE > _Entry
 That's the type of crap I am hosting. More...
 
typedef std::vector< _Entry_Base
 Object types: typedef myself as Base. More...
 
typedef std::vector< _Entry >::const_iterator _BaseConstIter
 
typedef std::vector< _Entry >::value_type _BaseValueType
 

Protected Member Functions

void _setEnvironment (const DataObject *pObj, const ContainedObject *pContd) const
 Set the environment for the vector and all contained objects references. More...
 

Protected Attributes

const DataObjectm_data
 Object data: Pointer to the identifiable object the link originates. More...
 
const ContainedObjectm_contd
 Object data: Pointer to the Contained object (if applicable) More...
 

Friends

StreamBufferoperator<< (StreamBuffer &_s, const SmartRefVector< TYPE > &ptr)
 Output Streamer operator. More...
 
StreamBufferoperator>> (StreamBuffer &_s, SmartRefVector< TYPE > &ptr)
 Input Streamer operator. More...
 

Additional Inherited Members

- Public Attributes inherited from std::vector< SmartRef< TYPE > >
SmartRef< TYPE > elements
 STL member. More...
 
- Static Private Member Functions inherited from SmartRefVectorImpl::SmartRefVectorPythonizer
static void __cppyy_pythonize__ (PyObject *klass, const std::string &name)
 

Detailed Description

template<class TYPE>
class SmartRefVector< TYPE >

Kernel objects: SmartRefVector.

Description: The SmartRefVector class allows transparent handling of multiple object links within the data store. Links are unloaded a priori and will only be loaded "on demand", i.e. when dereferenced.

SmartRefVectors should behave in the same way as normal vectors of pointers;

Using SmartRefVectors the environment of the vector is automatically propagated to each contained reference.

In order to speed things up, an attempt was made to avoid any virtual functions.

Base Class: STL vector

Dependencies:

  • Base class: vector
  • SmartRef constructs: Gaudi/Kernel/SmartRef.h

History :

+---------+----------------------------------------------+--------+
|    Date |                 Comment                      | Who    |
+---------+----------------------------------------------+--------+
| 12/07/99| Initial version.                             | MF     |
+---------+----------------------------------------------+--------+

Author: M.Frank Version: 1.0

Definition at line 79 of file SmartRefVector.h.

Member Typedef Documentation

◆ _Base

template<class TYPE >
typedef std::vector<_Entry> SmartRefVector< TYPE >::_Base
protected

Object types: typedef myself as Base.

Definition at line 84 of file SmartRefVector.h.

◆ _BaseConstIter

template<class TYPE >
typedef std::vector<_Entry>::const_iterator SmartRefVector< TYPE >::_BaseConstIter
protected

Definition at line 85 of file SmartRefVector.h.

◆ _BaseValueType

template<class TYPE >
typedef std::vector<_Entry>::value_type SmartRefVector< TYPE >::_BaseValueType
protected

Definition at line 86 of file SmartRefVector.h.

◆ _Entry

template<class TYPE >
typedef SmartRef<TYPE> SmartRefVector< TYPE >::_Entry
protected

That's the type of crap I am hosting.

Definition at line 82 of file SmartRefVector.h.

Constructor & Destructor Documentation

◆ SmartRefVector() [1/3]

template<class TYPE >
SmartRefVector< TYPE >::SmartRefVector ( )
inline

Standard Constructor.

Definition at line 104 of file SmartRefVector.h.

104  {
105  m_contd = 0;
106  m_data = 0;
107  }

◆ SmartRefVector() [2/3]

template<class TYPE >
template<class ITERATOR >
SmartRefVector< TYPE >::SmartRefVector ( ITERATOR  first,
ITERATOR  last 
)
inline

templated Constructor

Definition at line 110 of file SmartRefVector.h.

111  : std::vector<SmartRef<TYPE>>( first, last ), m_data( 0 ), m_contd( 0 ) {}

◆ SmartRefVector() [3/3]

template<class TYPE >
SmartRefVector< TYPE >::SmartRefVector ( const SmartRefVector< TYPE > &  copy)
inline

Copy Constructor.

Definition at line 113 of file SmartRefVector.h.

113 : std::vector<SmartRef<TYPE>>( copy ) { *this = copy; }

Member Function Documentation

◆ _setEnvironment()

template<class TYPE >
void SmartRefVector< TYPE >::_setEnvironment ( const DataObject pObj,
const ContainedObject pContd 
) const
inlineprotected

Set the environment for the vector and all contained objects references.

Definition at line 94 of file SmartRefVector.h.

94  {
95  m_data = pObj;
96  m_contd = pContd;
97  for ( _BaseConstIter i = _Base::begin(); i != _Base::end(); ++i ) { ( *i )._setEnvironment( pObj, pContd ); }
98  }

◆ operator()() [1/4]

template<class TYPE >
const SmartRefVector<TYPE>& SmartRefVector< TYPE >::operator() ( const ContainedObject pObj) const
inline

operator() const: assigns parent object for serialisation

Definition at line 124 of file SmartRefVector.h.

124  {
125  _setEnvironment( ( 0 == pObj ) ? 0 : pObj->parent(), pObj );
126  return *this;
127  }

◆ operator()() [2/4]

template<class TYPE >
const SmartRefVector<TYPE>& SmartRefVector< TYPE >::operator() ( const DataObject pObj) const
inline

operator() const: assigns parent object for serialisation

Definition at line 134 of file SmartRefVector.h.

134  {
135  _setEnvironment( pObj, 0 );
136  return *this;
137  }

◆ operator()() [3/4]

template<class TYPE >
SmartRefVector<TYPE>& SmartRefVector< TYPE >::operator() ( ContainedObject pObj)
inline

Standard destructor.

operator(): assigns parent object for serialisation

Definition at line 119 of file SmartRefVector.h.

119  {
120  _setEnvironment( ( 0 == pObj ) ? 0 : pObj->parent(), pObj );
121  return *this;
122  }

◆ operator()() [4/4]

template<class TYPE >
SmartRefVector<TYPE>& SmartRefVector< TYPE >::operator() ( DataObject pObj)
inline

operator(): assigns parent object for serialisation

Definition at line 129 of file SmartRefVector.h.

129  {
130  _setEnvironment( pObj, 0 );
131  return *this;
132  }

◆ operator=()

template<class TYPE >
SmartRefVector<TYPE>& SmartRefVector< TYPE >::operator= ( const SmartRefVector< TYPE > &  copy)
inline

Assignment.

Definition at line 139 of file SmartRefVector.h.

139  {
140  _Base::operator=( copy );
141  // Harms.... MF
142  // on copy we MUST make a 1 to 1 copy
143  // _setEnvironment( copy.m_data, copy.m_contd );
144  // use instead:
145  m_data = copy.m_data;
146  m_contd = copy.m_contd;
147  return *this;
148  }

◆ readRefs()

template<class TYPE >
StreamBuffer & SmartRefVector< TYPE >::readRefs ( StreamBuffer s)
inline

Helper to read references.

Definition at line 175 of file SmartRefVector.h.

175  {
176  long len;
178  s >> len;
179  for ( long i = 0; i < len; i++ ) {
180  _BaseValueType entry;
181  entry._setEnvironment( m_data, m_contd );
182  entry.readRef( s );
183  _Base::push_back( entry );
184  }
185  return s;
186 }

◆ type()

template<class TYPE >
const std::type_info* SmartRefVector< TYPE >::type ( ) const
inline

Access to embedded type.

Definition at line 150 of file SmartRefVector.h.

150 { return &typeid( TYPE ); }

◆ writeRefs()

template<class TYPE >
StreamBuffer & SmartRefVector< TYPE >::writeRefs ( StreamBuffer s) const
inline

Helper to write references.

Definition at line 164 of file SmartRefVector.h.

164  {
165  long len = _Base::size();
166  s << len;
167  for ( _BaseConstIter i = _Base::begin(); i != _Base::end(); i++ ) {
168  ( *i )._setEnvironment( m_data, m_contd );
169  ( *i ).writeRef( s );
170  }
171  return s;
172 }

Friends And Related Function Documentation

◆ operator<<

template<class TYPE >
StreamBuffer& operator<< ( StreamBuffer _s,
const SmartRefVector< TYPE > &  ptr 
)
friend

Output Streamer operator.

Definition at line 157 of file SmartRefVector.h.

157 { return ptr.writeRefs( _s ); }

◆ operator>>

template<class TYPE >
StreamBuffer& operator>> ( StreamBuffer _s,
SmartRefVector< TYPE > &  ptr 
)
friend

Input Streamer operator.

Definition at line 160 of file SmartRefVector.h.

160 { return ptr.readRefs( _s ); }

Member Data Documentation

◆ m_contd

template<class TYPE >
const ContainedObject* SmartRefVector< TYPE >::m_contd
mutableprotected

Object data: Pointer to the Contained object (if applicable)

Definition at line 91 of file SmartRefVector.h.

◆ m_data

template<class TYPE >
const DataObject* SmartRefVector< TYPE >::m_data
mutableprotected

Object data: Pointer to the identifiable object the link originates.

Definition at line 89 of file SmartRefVector.h.


The documentation for this class was generated from the following file:
gaudirun.s
string s
Definition: gaudirun.py:346
std::vector
STL class.
std::vector::size
T size(T... args)
SmartRefVector::_BaseValueType
std::vector< _Entry >::value_type _BaseValueType
Definition: SmartRefVector.h:86
SmartRefVector::m_contd
const ContainedObject * m_contd
Object data: Pointer to the Contained object (if applicable)
Definition: SmartRefVector.h:91
std::vector::push_back
T push_back(T... args)
std::vector::erase
T erase(T... args)
std::copy
T copy(T... args)
SmartRefVector::writeRefs
StreamBuffer & writeRefs(StreamBuffer &s) const
Helper to write references.
Definition: SmartRefVector.h:164
SmartRefVector::_BaseConstIter
std::vector< _Entry >::const_iterator _BaseConstIter
Definition: SmartRefVector.h:85
SmartRefVector::m_data
const DataObject * m_data
Object data: Pointer to the identifiable object the link originates.
Definition: SmartRefVector.h:89
ContainedObject::parent
const ObjectContainerBase * parent() const
Access to parent object.
Definition: ContainedObject.h:63
std::vector::begin
T begin(T... args)
std::vector::operator=
T operator=(T... args)
SmartRefVector::readRefs
StreamBuffer & readRefs(StreamBuffer &s)
Helper to read references.
Definition: SmartRefVector.h:175
std::vector::end
T end(T... args)
SmartRefVector::_setEnvironment
void _setEnvironment(const DataObject *pObj, const ContainedObject *pContd) const
Set the environment for the vector and all contained objects references.
Definition: SmartRefVector.h:94