The Gaudi Framework  v29r0 (ff2e7097)
KeyedTraits.h
Go to the documentation of this file.
1 #ifndef GAUDIKERNEL_KEYEDTRAITS_H
2 #define GAUDIKERNEL_KEYEDTRAITS_H
3 
4 #define CHECK_KEYED_CONTAINER
5 
6 // Include files
7 #include "GaudiKernel/Kernel.h" // GAUDI_API
8 #include <vector>
9 
10 // Forward declarations
11 template <class K>
12 class KeyedObject;
13 template <class T, class M>
14 class KeyedContainer;
15 
16 /*
17  Namespace for Key classes used by the Keyed Container
18 */
19 namespace Containers
20 {
21 
22  // Status enumeration
23  enum {
29  };
30 
31  // Forward declarations
32 
34  template <class CONTAINER, class DATATYPE>
35  struct traits;
37  template <class KEY>
38  struct key_traits;
40  template <class SETUP>
41  class KeyedObjectManager;
42 
46 
50 
55 
58 
70  template <class KEY>
71  struct key_traits {
73  typedef KEY key_type;
80  static key_type makeKey( long k ) { return key_type( k ); }
81  static key_type makeKey( int k ) { return key_type( k ); }
83  static long identifier( const key_type& k ) { return k; }
85  static long hash( const key_type& key_value ) { return key_value; }
87  static void setKey( obj_type* v, const key_type& k )
88  {
89  if ( v ) v->setKey( k );
90  }
95  static bool checkKey( obj_type* v, const key_type& k )
96  {
97 #ifdef CHECK_KEYED_CONTAINER
98  return ( v ) ? ( hash( v->key() ) == hash( k ) ) : false;
99 #else
100  return true;
101 #endif
102  }
104  static long addRef( obj_type* v ) { return ( v ) ? v->addRef() : 0; }
106  static long release( obj_type* v ) { return ( v ) ? v->release() : 0; }
107  };
108 
117  template <class CONTAINER, class DATATYPE>
118  struct traits : public key_traits<typename DATATYPE::key_type> {
120  static bool checkBounds( const std::vector<DATATYPE*>* cnt, const typename DATATYPE::key_type& k )
121  {
122 #ifdef CHECK_KEYED_CONTAINER
123  return size_t( cnt->size() ) > size_t( traits::hash( k ) );
124 #else
125  return true;
126 #endif
127  }
128  };
129 }
130 #endif // GAUDIKERNEL_KEYEDTRAITS_H
Object was inserted into the container.
Definition: KeyedTraits.h:27
static long addRef(obj_type *v)
Add reference counter to object when inserted into the container.
Definition: KeyedTraits.h:104
Container traits class.
Definition: KeyedTraits.h:35
static key_type makeKey(int k)
Definition: KeyedTraits.h:81
static bool checkBounds(const std::vector< DATATYPE * > *cnt, const typename DATATYPE::key_type &k)
Allow to check the access to container elements for consistency.
Definition: KeyedTraits.h:120
Definition of the templated KeyedObject class.
Definition: KeyedObject.h:30
GAUDI_API void containerIsInconsistent()
Function to be called to indicate that the container is found to be inconsistent. ...
template class KeyedContainer, KeyedContainer.h
static bool checkKey(obj_type *v, const key_type &k)
Check the validity of the object&#39;s key.
Definition: KeyedTraits.h:95
static key_type makeKey(long k)
Create key from its full integer representation.
Definition: KeyedTraits.h:80
Key traits class.
Definition: KeyedTraits.h:38
Containers namespace.
Object was removed from the container and deleted.
Definition: KeyedTraits.h:25
KeyedObject< key_type > obj_type
Declaration of keyed object type.
Definition: KeyedTraits.h:75
GAUDI_API void cannotInsertToContainer()
Function to be called to indicate that an object cannot be inserted to the container.
void setKey(const key_type &key)
Set object key.
Definition: KeyedObject.h:127
KEY key_type
Declaration of key-type.
Definition: KeyedTraits.h:73
static long hash(const key_type &key_value)
Hash function for this key.
Definition: KeyedTraits.h:85
Cannot insert object into container.
Definition: KeyedTraits.h:28
GAUDI_API void invalidContainerOperation()
Function to be called to indicate that an operation should be performed on the container or it&#39;s cont...
const key_type & key() const
Retrieve Key of the object.
Definition: KeyedObject.h:74
unsigned long addRef()
Add reference to object (Increase reference counter).
Definition: KeyedObject.h:108
unsigned long release()
Release reference. If the reference count is ZERO, delete the object.
Definition: KeyedObject.h:115
static long identifier(const key_type &k)
Full unhashed key identifier.
Definition: KeyedTraits.h:83
Object was removed, but not deleted.
Definition: KeyedTraits.h:26
T size(T...args)
STL class.
GAUDI_API void cannotAssignObjectKey()
Function to be called when an object key cannot be assigned.
KeyedObjectManager Class to manage keyed objects.
Object not present in the container.
Definition: KeyedTraits.h:24
static long release(obj_type *v)
Release reference to object.
Definition: KeyedTraits.h:106
#define GAUDI_API
Definition: Kernel.h:110
static void setKey(obj_type *v, const key_type &k)
Set object key when inserted into the container.
Definition: KeyedTraits.h:87