Make an AuxVectorData object from either a raw array or an aux store. More...

#include <AuxVectorInterface.h>

Inheritance diagram for SG::AuxVectorInterface:

Collaboration diagram for SG::AuxVectorInterface:

Public Member Functions
	AuxVectorInterface (IAuxStore &store)
	Build from a (non-const) auxiliary store. More...

	AuxVectorInterface (const IConstAuxStore &store)
	Build from a (const) auxiliary store. More...

	AuxVectorInterface (SG::auxid_t auxid, size_t size, void *ptr)
	Build from a (non-const) raw array. More...

	AuxVectorInterface (SG::auxid_t auxid, size_t size, const void *ptr)
	Build from a (const) raw array. More...

virtual size_t	size_v () const override final
	Return the size of the container. More...

virtual size_t	capacity_v () const override final
	Return the capacity of the container. More...

Private Attributes
size_t	m_size
	Size of the container. More...

Aux store management.
const SG::IConstAuxStore *	getConstStore () const
	Return the current store, as a const interface. More...

const DataLink< SG::IConstAuxStore >	getConstStoreLink () const
	Return the data link to the current store, as a const interface. More...

SG::IAuxStore *	getStore ()
	Return the current store, as a non-const interface. More...

const SG::IAuxStore *	getStore () const
	Return the current store, as a non-const interface. More...

bool	hasStore () const
	Return true if this object has an associated store. More...

bool	hasNonConstStore () const
	Return true if this object has an associated non-const store. More...

bool	setOption (auxid_t id, const AuxDataOption &option)
	Set an option for an auxiliary data variable. More...

bool	setOption (const std::string &name, const AuxDataOption &option)
	Set an option for an auxiliary data variable. More...

bool	setOption (const std::string &name, const std::string &clsname, const AuxDataOption &option)
	Set an option for an auxiliary data variable. More...

template<class T >
bool	setOption (auxid_t id, const std::string &optname, T arg)
	Set an option for an auxiliary data variable. More...

bool	setOption (const std::string &name, const std::string &optname, int arg)
	Set an option for an auxiliary data variable. More...

bool	setOption (const std::string &name, const std::string &optname, float arg)

bool	setOption (const std::string &name, const std::string &optname, double arg)

template<class T >
bool	setOption (const std::string &name, const std::string &clsname, const std::string &optname, T arg)
	Set an option for an auxiliary data variable. More...

void	setStore (SG::IAuxStore *store)
	Set the store associated with this object. More...

void	setStore (const SG::IConstAuxStore *store)
	Set the store associated with this object. More...

void	setStore (const DataLink< SG::IConstAuxStore > &store)
	Set the store associated with this object. More...

void	setNonConstStore (SG::IAuxStore *store)
	Set the store associated with this object. More...

Data access.
const SG::auxid_set_t &	getAuxIDs () const
	Return a set of identifiers for existing data items in store associated with this object. More...

const SG::auxid_set_t &	getDecorIDs () const
	Return a set of identifiers for decorations for this object. More...

const SG::auxid_set_t &	getWritableAuxIDs () const
	Return a set of identifiers for writable data items in this store. More...

bool	isAvailable (auxid_t id) const
	Test to see if a variable exists in the store. More...

bool	isAvailableWritable (auxid_t id)
	Test to see if a variable is available for writing. More...

bool	isAvailableWritableAsDecoration (auxid_t id) const
	Test to see if a variable is available for writing as a decoration. More...

template<class T >
AuxDataTraits< T >::reference_type	getData (SG::auxid_t auxid, size_t ndx)
	Return reference to an aux data item. More...

template<class T >
AuxDataTraits< T >::const_reference_type	getData (SG::auxid_t auxid, size_t ndx) const
	Return const reference to an aux data item. More...

template<class T >
AuxDataTraits< T >::reference_type	getDecoration (SG::auxid_t auxid, size_t ndx) const
	Return reference to an aux decoration item. More...

const void *	getDataArray (SG::auxid_t auxid) const
	Return a const pointer to the start of an aux data vector. More...

void *	getDataArray (SG::auxid_t auxid)
	Return a pointer to the start of an aux data vector. More...

const void *	getDataArrayAllowMissing (SG::auxid_t auxid) const
	Return a const pointer to the start of an aux data vector. More...

void *	getDecorationArray (SG::auxid_t auxid) const
	Return a pointer to the start of an aux data vector for a decoration. More...

const AuxDataSpanBase *	getDataSpan (SG::auxid_t auxid) const
	Return a reference to a description of this vector's start+size. More...

static size_t s_minCacheLen	ATLAS_THREAD_SAFE
	Minimum length to use for the cache vector. More...

Other operations.
Cache m_cache	ATLAS_THREAD_SAFE
	Cached pointers to the start of aux data vectors, non-const. More...

Cache m_constCache	ATLAS_THREAD_SAFE
	Cached pointers to the start of aux data vectors, const. More...

Cache m_decorCache	ATLAS_THREAD_SAFE
	Cached pointers to the start of aux data vectors, decorations. More...

Cache m_spanCache	ATLAS_THREAD_SAFE
	Cached pointers to span descriptors. More...

SG::IAuxStore *	m_store
	Associated store, non-const. More...

const SG::IConstAuxStore *	m_constStore
	Associated store, const. More...

DataLink< SG::IConstAuxStore >	m_constStoreLink
	Associated store link, const. More...

mutex_t	m_mutex

void	swap (AuxVectorData &other)
	Swap this instance with another. More...

void	clearCache ()
	Clear the cached aux data pointers. More...

void	clearCache (SG::auxid_t auxid)
	Clear the cached aux data pointers for a single variable. More...

void	clearDecorCache (SG::auxid_t auxid)
	Clear the cached decoration pointer for a single variable. More...

virtual void	lock () override
	Lock the container. More...

bool	clearDecorations () const
	Clear all decorations. More...

void	lockDecoration (SG::auxid_t auxid)
	Explicitly lock a decoration. More...

const SG::IConstAuxStore *	getConstStoreOol () const
	Same as getConstStore. More...

typedef AthContainers_detail::mutex	mutex_t
	Mutex used to synchronize modifications to the cache vector. More...

typedef AthContainers_detail::lock_guard< mutex_t >	guard_t

static const SG::auxid_set_t	s_emptySet
	Empty auxid set, used for a return value when we have no associated store. More...

void	setCache (SG::auxid_t auxid, void *ptr)
	Explicitly set a cache pointer. More...

void	setCache (SG::auxid_t auxid, const void *ptr)
	Explicitly set a cache pointer. More...

bool	isAvailableOol (auxid_t id) const
	Out-of-line portion of isAvailable. More...

bool	isAvailableWritableOol (auxid_t id)
	Out-of-line portion of isAvailableWritable. More...

bool	isAvailableWritableAsDecorationOol (auxid_t id) const
	Out-of-line portion of isAvailableWritableAsDecoration. More...

void *	getDataOol (SG::auxid_t auxid, bool allowMissing)
	Out-of-line portion of data access. More...

const void *	getDataOol (SG::auxid_t auxid, bool allowMissing) const
	Out-of-line portion of data access (const version). More...

void *	getDecorationOol (SG::auxid_t auxid) const
	Out-of-line portion of data access (decorator version). More...

const AuxDataSpanBase *	getDataSpanOol (SG::auxid_t auxid, bool allowMissing) const
	Return a reference to a description of this vector's start+size, out-of-line portion. More...

Detailed Description

Make an AuxVectorData object from either a raw array or an aux store.

The swap/copy/clear operations in AuxTypeRegistry take AuxVectorData instances as input. But sometimes we have only the auxiliary store, or even just a pointer to a raw array. In that case, we can create a temporary instance of this class to wrap the data.

Definition at line 31 of file AuxVectorInterface.h.

Member Typedef Documentation

◆ guard_t

typedef AthContainers_detail::lock_guard<mutex_t> SG::AuxVectorData::guard_t

privateinherited

Definition at line 989 of file AuxVectorData.h.

◆ mutex_t

typedef AthContainers_detail::mutex SG::AuxVectorData::mutex_t

privateinherited

Mutex used to synchronize modifications to the cache vector.

Definition at line 988 of file AuxVectorData.h.

Constructor & Destructor Documentation

◆ AuxVectorInterface() [1/4]

SG::AuxVectorInterface::AuxVectorInterface ( IAuxStore & store )

Build from a (non-const) auxiliary store.

Parameters

store The auxiliary store to wrap.

◆ AuxVectorInterface() [2/4]

SG::AuxVectorInterface::AuxVectorInterface ( const IConstAuxStore & store )

Build from a (const) auxiliary store.

Parameters

store The auxiliary store to wrap.

◆ AuxVectorInterface() [3/4]

SG::AuxVectorInterface::AuxVectorInterface	(	SG::auxid_t	auxid,
		size_t	size,
		void *	ptr
	)

Build from a (non-const) raw array.

Parameters

auxid	ID of the represented variable.
size	Length of the array.
ptr	Pointer to the array.

◆ AuxVectorInterface() [4/4]

SG::AuxVectorInterface::AuxVectorInterface	(	SG::auxid_t	auxid,
		size_t	size,
		const void *	ptr
	)

Build from a (const) raw array.

Parameters

auxid	ID of the represented variable.
size	Length of the array.
ptr	Pointer to the array.

Member Function Documentation

◆ capacity_v()

virtual size_t SG::AuxVectorInterface::capacity_v ( ) const

finaloverridevirtual

Return the capacity of the container.

Implements SG::AuxVectorData.

◆ clearCache() [1/2]

void SG::AuxVectorData::clearCache ( )

inherited

Clear the cached aux data pointers.

You should call this any time something changes in the aux store that could invalidate the vector pointers.

◆ clearCache() [2/2]

void SG::AuxVectorData::clearCache ( SG::auxid_t auxid )

inherited

Clear the cached aux data pointers for a single variable.

Parameters

auxid ID of the variable to clear.

Not really safe to use if another thread may be accessing the same decoration.

◆ clearDecorations()

bool SG::AuxVectorData::clearDecorations ( ) const

inherited

Clear all decorations.

Erase all decorations from the store, restoring the state to when lock was called.

Returns true if there were any decorations that were cleared, false if the store did not contain any decorations.

Definition at line 653 of file AuxVectorData.cxx.

 {
   bool ret = false;
   if (m_store) {
     // Avoid warning about calling non-const function.  OK here.
     IAuxStore* store ATLAS_THREAD_SAFE = m_store;
     ret = store->clearDecorations();
     m_cache.clear();
     m_constCache.clear();
     m_decorCache.clear();
   }
   else if (getConstStore()) {
     // The whole point of decorations is to allow adding information to
     // something that's otherwise const.  So we have the const_cast here.
     // The store object is responsible for determining whether the
     // modification is really allowed or not.
     IConstAuxStore* store ATLAS_THREAD_SAFE =
        const_cast<IConstAuxStore*> (getConstStore());
     ret = store->clearDecorations();
   }
   else
     throw SG::ExcNoAuxStore ("lock");
   return ret;
 }

◆ clearDecorCache()

void SG::AuxVectorData::clearDecorCache ( SG::auxid_t auxid )

inherited

Clear the cached decoration pointer for a single variable.

Parameters

auxid ID of the variable to clear.

Not really safe to use if another thread may be accessing the same decoration.

◆ getAuxIDs()

const SG::auxid_set_t & SG::AuxVectorData::getAuxIDs ( ) const

inherited

Return a set of identifiers for existing data items in store associated with this object.

This will include identifiers for all items, const and non-const. If no store is associated with this object, this will return an empty set.

Definition at line 203 of file AuxVectorData.cxx.

 {
   const SG::IConstAuxStore* store = getConstStore();
   if (store)
     return store->getAuxIDs();
   return s_emptySet;
 }

◆ getConstStore()

const SG::IConstAuxStore* SG::AuxVectorData::getConstStore ( ) const

inherited

Return the current store, as a const interface.

This will be non-zero if either a const or non-const store is associated with this object.

◆ getConstStoreLink()

const DataLink<SG::IConstAuxStore> SG::AuxVectorData::getConstStoreLink ( ) const

inherited

Return the data link to the current store, as a const interface.

This is set by persistency when reading an object, but it may be overridden by setting the store pointer directly.

◆ getConstStoreOol()

const SG::IConstAuxStore * SG::AuxVectorData::getConstStoreOol ( ) const

inherited

Same as getConstStore.

But out-of-line, as sometimes the debugger has problems calling inline functions.

Definition at line 704 of file AuxVectorData.cxx.

 {
   return getConstStore();
 }

◆ getData() [1/2]

template<class T >

AuxDataTraits<T>::reference_type SG::AuxVectorData::getData	(	SG::auxid_t	auxid,
		size_t	ndx
	)

inherited

Return reference to an aux data item.

Parameters

auxid	The desired aux data item.
ndx	Index of the element to return.

This will return a reference to element ndx of aux data item auxid. If the aux data item does not exist, it will be created. Errors are signaled by raising an exception.

Warning: no type checking is done. You should usually access the data via Accessor or ConstAccessor.

◆ getData() [2/2]

template<class T >

AuxDataTraits<T>::const_reference_type SG::AuxVectorData::getData	(	SG::auxid_t	auxid,
		size_t	ndx
	)		const

inherited

Return const reference to an aux data item.

Parameters

auxid	The desired aux data item.
ndx	Index of the element to return.

This will return a reference to element ndx of aux data item auxid. Errors are signaled by raising an exception.

Warning: no type checking is done. You should usually access the data via Accessor or ConstAccessor.

◆ getDataArray() [1/2]

void* SG::AuxVectorData::getDataArray ( SG::auxid_t auxid )

inherited

Return a pointer to the start of an aux data vector.

Parameters

auxid The desired aux data item.

This will return a pointer to the start of the data for aux data item auxid. If the item doesn't exist, it will be created. Errors are signaled by raising an exception.

◆ getDataArray() [2/2]

const void* SG::AuxVectorData::getDataArray ( SG::auxid_t auxid ) const

inherited

Return a const pointer to the start of an aux data vector.

Parameters

auxid The desired aux data item.

This will return a pointer to the start of the data for aux data item auxid. Errors are signaled by raising an exception.

◆ getDataArrayAllowMissing()

const void* SG::AuxVectorData::getDataArrayAllowMissing ( SG::auxid_t auxid ) const

inherited

Return a const pointer to the start of an aux data vector.

Parameters

auxid The desired aux data item.

This will return a pointer to the start of the data for aux data item auxid. If the item does not exist, this will return nullptr rather than raising an exception.

◆ getDataOol() [1/2]

void * SG::AuxVectorData::getDataOol	(	SG::auxid_t	auxid,
		bool	allowMissing
	)

privateinherited

Out-of-line portion of data access.

Parameters

auxid	aux data item being accessed.
allowMissing	If true, then return nullptr if the variable is missing rather than throwing an exception.

When this function returns, the cache entry m_cache[auxid] will be valid. That entry is also returned. If there's an error, the function will throw an exception rather than returning.

Definition at line 308 of file AuxVectorData.cxx.

 {
   guard_t guard (m_mutex);
  
   // Fetch the pointer from the store, or raise an exception if we don't
   // have a non-const store.
   void* ptr = 0;
   if (m_store) {
     if (SG::AuxTypeRegistry::instance().isLinked (auxid)) {
       ptr = m_store->getData (auxid, 0, 0);
     }
     else {
       ptr = m_store->getData (auxid, this->size_v(), this->capacity_v());
     }
   }
   else if (getConstStore())
     throw SG::ExcConstAuxData ("fetch item", auxid);
   else
     throw SG::ExcNoAuxStore (auxid);
  
   // Check that we got a good pointer back, otherwise throw.
   if (ptr) {
     m_cache.store (auxid, ptr);
  
     // Set the same entry in the other caches as well.
     m_constCache.store (auxid, ptr);
     m_decorCache.store (auxid, ptr);
   }
   else if (!allowMissing)
     throw SG::ExcBadAuxVar (auxid);
  
   return ptr;
 }

◆ getDataOol() [2/2]

const void * SG::AuxVectorData::getDataOol	(	SG::auxid_t	auxid,
		bool	allowMissing
	)		const

privateinherited

Out-of-line portion of data access (const version).

Parameters

auxid	aux data item being accessed.
allowMissing	If true, then return nullptr if the variable is missing rather than throwing an exception.

When this function returns, the cache entry m_constCache[auxid] will be valid. That entry is also returned. If there's an error, the function will throw an exception rather than returning.

Definition at line 353 of file AuxVectorData.cxx.

 {
   guard_t guard (m_mutex);
  
   // Fetch the pointer from the store, or raise an exception if we don't
   // have a const store.
   const void* ptr = 0;
   const SG::IConstAuxStore* store = getConstStore();
   if (store)
     ptr = store->getData (auxid);
   else
     throw SG::ExcNoAuxStore (auxid);
  
   // Check that we got a good pointer back, otherwise throw.
   if (ptr) {
     // We could avoid the const_cast here by having distinct const and
     // non-const Cache types, holding const void* and void*, respectively.
     // However, since this is a purely internal class that users don't
     // deal with directly, that's not worth the bother (and the extra code).
     void* vp ATLAS_THREAD_SAFE = const_cast<void*> (ptr);
     m_constCache.store (auxid, vp);
   }
   else if (!allowMissing)
     throw SG::ExcBadAuxVar (auxid);
  
   return ptr;
 }

◆ getDataSpan()

const AuxDataSpanBase* SG::AuxVectorData::getDataSpan ( SG::auxid_t auxid ) const

inherited

Return a reference to a description of this vector's start+size.

Parameters

auxid The desired aux data item.

This low-overhead method of getting the start+size of an auxiliary variable. The returned object will be updated if the variable's vector changes. Raises an exception if the variable does not exist.

This is in principle a const-correctness violation, since AuxDataSpanBase has a non-const pointer to the start of the vector. But doing it properly is kind of painful, and as this interface is only meant to be used internally, it's likely not a real problem.

◆ getDataSpanOol()

const AuxDataSpanBase * SG::AuxVectorData::getDataSpanOol	(	SG::auxid_t	auxid,
		bool	allowMissing
	)		const

privateinherited

Return a reference to a description of this vector's start+size, out-of-line portion.

Parameters

auxid	The desired aux data item.
allowMissing	If true, then return nullptr if the variable is missing rather than throwing an exception.

When this function returns, the cache entry m_spanCache[auxid] will be valid. That entry is also returned. If there's an error, the function will throw an exception rather than returning.

Definition at line 456 of file AuxVectorData.cxx.

 {
   guard_t guard (m_mutex);
  
   // Fetch the pointer from the store, or raise an exception if we don't
   // have a const store.
   const IAuxTypeVector* v = 0;
   const SG::IConstAuxStore* store = getConstStore();
   if (store)
     v = store->getVector (auxid);
   else
     throw SG::ExcNoAuxStore (auxid);
  
   // Check that we got a good pointer back, otherwise throw.
   const AuxDataSpanBase* ptr = nullptr;
   if (v) {
     ptr = &v->getDataSpan();
     // We could avoid the const_cast here by having distinct const and
     // non-const Cache types, holding const void* and void*, respectively.
     // However, since this is a purely internal class that users don't
     // deal with directly, that's not worth the bother (and the extra code).
     AuxDataSpanBase* vp ATLAS_THREAD_SAFE = const_cast<AuxDataSpanBase*> (ptr);
     m_spanCache.store (auxid, vp);
   }
   else if (!allowMissing)
     throw SG::ExcBadAuxVar (auxid);
  
   return ptr;
 }

◆ getDecoration()

template<class T >

AuxDataTraits<T>::reference_type SG::AuxVectorData::getDecoration	(	SG::auxid_t	auxid,
		size_t	ndx
	)		const

inherited

Return reference to an aux decoration item.

Parameters

auxid	The desired aux decoration item.
ndx	Index of the element to return.

This will return a reference to element ndx of aux decoration item auxid. If the aux data item does not exist, it will be created. Errors are signaled by raising an exception.

Warning: no type checking is done. You should usually access the data via Decorator.

The difference between getDecoration and getData is that getDecoration takes a const container as input, but returns a non-const reference. This will only succeed if either the container is not locked or the item was first accessed as a decoration.

◆ getDecorationArray()

void* SG::AuxVectorData::getDecorationArray ( SG::auxid_t auxid ) const

inherited

Return a pointer to the start of an aux data vector for a decoration.

Parameters

auxid The desired aux data item.

This will return a pointer to the start of the data for aux data item auxid. If the item doesn't exist, it will be created. Errors are signaled by raising an exception.

The difference between getDecorationArray and getDataArray is that getDecorationArray takes a const container as input, but returns a non-const pointer. This will only succeed if either the container is not locked or the item was first accessed as a decoration.

◆ getDecorationOol()

void * SG::AuxVectorData::getDecorationOol ( SG::auxid_t auxid ) const

privateinherited

Out-of-line portion of data access (decorator version).

Parameters

auxid aux data item being accessed.

When this function returns, the cache entry m_cache[auxid] will be valid. That entry is also returned. If there's an error, the function will throw an exception rather than returning.

The difference between getDecorationOol and getDataOol is that getDecorationOol takes a const container as input, but returns a non-const pointer. This will only succeed if either the container is not locked or the item was first accessed as a decoration.

Definition at line 397 of file AuxVectorData.cxx.

 {
   guard_t guard (m_mutex);
  
   // Fetch the pointer from the store, or raise an exception if we don't
   // have a non-const store.
   void* ptr = 0;
   if (m_store) {
     // Avoid warning about calling non-const function.  OK here.
     IAuxStore* store ATLAS_THREAD_SAFE = m_store;
     if (SG::AuxTypeRegistry::instance().isLinked (auxid)) {
       ptr = store->getDecoration (auxid, 0, 0);
     }
     else {
       ptr = store->getDecoration (auxid, this->size_v(), this->capacity_v());
     }
   }
   else if (getConstStore()) {
     // The whole point of decorations is to allow adding information to
     // something that's otherwise const.  So we have the const_cast here.
     // The store object is responsible for determining whether the
     // modification is really allowed or not.
     IConstAuxStore* store ATLAS_THREAD_SAFE =
        const_cast<IConstAuxStore*> (getConstStore());
     if (SG::AuxTypeRegistry::instance().isLinked (auxid)) {
       ptr = store->getDecoration (auxid, 0, 0);
     }
     else {
       ptr = store->getDecoration (auxid, this->size_v(), this->capacity_v());
     }
   }
   else
     throw SG::ExcNoAuxStore (auxid);
  
   // Check that we got a good pointer back, otherwise throw.
   if (!ptr)
     throw SG::ExcBadAuxVar (auxid);
  
   m_decorCache.store (auxid, ptr);
  
   // Set the same entry in the const cache as well.
   m_constCache.store (auxid, ptr);
  
   return ptr;
 }

◆ getDecorIDs()

const SG::auxid_set_t & SG::AuxVectorData::getDecorIDs ( ) const

inherited

Return a set of identifiers for decorations for this object.

Definition at line 215 of file AuxVectorData.cxx.

 {
   if (getConstStore())
     return getConstStore()->getDecorIDs();
   return s_emptySet;
 }

◆ getStore() [1/2]

SG::IAuxStore* SG::AuxVectorData::getStore ( )

inherited

Return the current store, as a non-const interface.

This will be non-zero if a non-const store is associated with this object.

◆ getStore() [2/2]

const SG::IAuxStore* SG::AuxVectorData::getStore ( ) const

inherited

Return the current store, as a non-const interface.

This will be non-zero if a non-const store is associated with this object.

◆ getWritableAuxIDs()

const SG::auxid_set_t & SG::AuxVectorData::getWritableAuxIDs ( ) const

inherited

Return a set of identifiers for writable data items in this store.

This will include only non-const identifiers. If no store is associated with this object, this will return an empty set.

Definition at line 231 of file AuxVectorData.cxx.

 {
   if (m_store)
     return m_store->getWritableAuxIDs();
   return s_emptySet;
 }

◆ hasNonConstStore()

bool SG::AuxVectorData::hasNonConstStore ( ) const

inherited

Return true if this object has an associated non-const store.

◆ hasStore()

bool SG::AuxVectorData::hasStore ( ) const

inherited

Return true if this object has an associated store.

◆ isAvailable()

bool SG::AuxVectorData::isAvailable ( auxid_t id ) const

inherited

Test to see if a variable exists in the store.

Parameters

id	The variable to test.

◆ isAvailableOol()

bool SG::AuxVectorData::isAvailableOol ( auxid_t id ) const

privateinherited

Out-of-line portion of isAvailable.

Parameters

id	The variable to test.

Definition at line 243 of file AuxVectorData.cxx.

 {
   guard_t guard (m_mutex);
  
   const SG::IConstAuxStore* store = getConstStore();
   if (!store) return false;
  
   // Don't rely on getAuxIDs() --- the store can lie.
   // Explicitly try to fetch the data.
   const void* ptr = store->getData (id);
   if (ptr) {
     // We could avoid the const_cast here by having distinct const and
     // non-const Cache types, holding const void* and void*, respectively.
     // However, since this is a purely internal class that users don't
     // deal with directly, that's not worth the bother (and the extra code).
     void* vp ATLAS_THREAD_SAFE = const_cast<void*> (ptr);
     m_constCache.store (id, vp);
     return true;
   }
   return false;
 }

◆ isAvailableWritable()

bool SG::AuxVectorData::isAvailableWritable ( auxid_t id )

inherited

Test to see if a variable is available for writing.

Parameters

id	The variable to test.

◆ isAvailableWritableAsDecoration()

bool SG::AuxVectorData::isAvailableWritableAsDecoration ( auxid_t id ) const

inherited

Test to see if a variable is available for writing as a decoration.

Parameters

id	The variable to test.

◆ isAvailableWritableAsDecorationOol()

bool SG::AuxVectorData::isAvailableWritableAsDecorationOol ( auxid_t id ) const

privateinherited

Out-of-line portion of isAvailableWritableAsDecoration.

Parameters

id	The variable to test.

Definition at line 282 of file AuxVectorData.cxx.

 {
   if (!isAvailableOol (id)) return false;
  
   // Not nice, but not sure we can do otherwise without changing interfaces.
   // I think the case of a caught exception should be rare.
   try {
     this->getDecorationArray (id);
   }
   catch (const SG::ExcStoreLocked&) {
     return false;
   }
   return true;
 }

◆ isAvailableWritableOol()

bool SG::AuxVectorData::isAvailableWritableOol ( auxid_t id )

privateinherited

Out-of-line portion of isAvailableWritable.

Parameters

id	The variable to test.

Definition at line 270 of file AuxVectorData.cxx.

 {
   const SG::IAuxStore* store = getStore();
   if (!store) return false;
   return store->getWritableAuxIDs().test(id);
 }

◆ lock()

void SG::AuxVectorData::lock ( )

overridevirtualinherited

Lock the container.

After this, only decorations can be changed/modified. If the container is already locked, this is a no-op.

Implements ILockable.

Definition at line 633 of file AuxVectorData.cxx.

 {
   if (m_store) {
     m_store->lock();
     clearCache();
   }
  
   // No error if no store or no writable store.
 }

◆ lockDecoration()

void SG::AuxVectorData::lockDecoration ( SG::auxid_t auxid )

inherited

Explicitly lock a decoration.

Parameters

auxid ID of the decoration to lock.

This is only safe if no other thread can be accessing this decoration. It is strongly preferred to do this via a WriteDecorHandle, where the dependencies can help ensure this.

Definition at line 687 of file AuxVectorData.cxx.

 {
   const IConstAuxStore* store = this->getConstStore();
   if (store) {
     // Casting away const ok if no other thread is accessing this decoration.
     IConstAuxStore* store_nc ATLAS_THREAD_SAFE = const_cast<IConstAuxStore*> (store);
     store_nc->lockDecoration (auxid);
     this->clearDecorCache (auxid);
   }
 }

◆ setCache() [1/2]

void SG::AuxVectorData::setCache	(	SG::auxid_t	auxid,
		const void *	ptr
	)

protectedinherited

Explicitly set a cache pointer.

Parameters

auxid	Variable ID to set.
ptr	Pointer to which the cache entry should be set.

For internal use; do not use from user code. This does not acquire the lock — it's mostly meant to be used from a constructor.

◆ setCache() [2/2]

void SG::AuxVectorData::setCache	(	SG::auxid_t	auxid,
		void *	ptr
	)

protectedinherited

Explicitly set a cache pointer.

Parameters

auxid	Variable ID to set.
ptr	Pointer to which the cache entry should be set.

For internal use; do not use from user code. This does not acquire the lock — it's mostly meant to be used from a constructor.

◆ setNonConstStore()

void SG::AuxVectorData::setNonConstStore ( SG::IAuxStore * store )

protectedinherited

Set the store associated with this object.

Parameters

store The new store.

This will set both the const and non-const store pointers, and also clear the cache. This is the same as setStore() above with the same signature. It exists so that it can be called from python; pyroot would not be able to call the non-const overload of setStore due to its simplistic overload resolution.

◆ setOption() [1/8]

bool SG::AuxVectorData::setOption	(	auxid_t	id,
		const AuxDataOption &	option
	)

inherited

Set an option for an auxiliary data variable.

Parameters

id	The variable for which we want to set the option.
option	The option setting to make.

The interpretation of option depends on the associated auxiliary store. See PackedParameters.h for option settings for writing packed data. Returns true on success, false otherwise.

Definition at line 150 of file AuxVectorData.cxx.

 {
   if (id == null_auxid) return false;
   SG::IAuxStore* store = getStore();
   if (!store) return false;
   return store->setOption (id, option);
 }

◆ setOption() [2/8]

template<class T >

bool SG::AuxVectorData::setOption	(	auxid_t	id,
		const std::string &	optname,
		T	arg
	)

inherited

Set an option for an auxiliary data variable.

Parameters

id	The variable for which we want to set the option.
optname	The name of the option to set.
arg	The option value to set.

The interpretation of option depends on the associated auxiliary store. See PackedParameters.h for option settings for writing packed data. Returns true on success, false otherwise.

◆ setOption() [3/8]

bool SG::AuxVectorData::setOption	(	const std::string &	name,
		const AuxDataOption &	option
	)

inherited

Set an option for an auxiliary data variable.

Parameters

name	The name of the variable.
option	The option setting to make.

The interpretation of option depends on the associated auxiliary store. See PackedParameters.h for option settings for writing packed data. Returns true on success, false otherwise.

Definition at line 168 of file AuxVectorData.cxx.

 {
   auxid_t id = SG::AuxTypeRegistry::instance().findAuxID (name);
   return setOption (id, option);
 }

◆ setOption() [4/8]

bool SG::AuxVectorData::setOption	(	const std::string &	name,
		const std::string &	clsname,
		const AuxDataOption &	option
	)

inherited

Set an option for an auxiliary data variable.

Parameters

name	The name of the variable.
clsname	The name of the associated class. May be blank.
option	The option setting to make.

The interpretation of option depends on the associated auxiliary store. See PackedParameters.h for option settings for writing packed data. Returns true on success, false otherwise.

Definition at line 186 of file AuxVectorData.cxx.

 {
   auxid_t id = SG::AuxTypeRegistry::instance().findAuxID (name, clsname);
   return setOption (id, option);
 }

◆ setOption() [5/8]

template<class T >

bool SG::AuxVectorData::setOption	(	const std::string &	name,
		const std::string &	clsname,
		const std::string &	optname,
		T	arg
	)

inherited

Set an option for an auxiliary data variable.

Parameters

name	The name of the variable.
clsname	The name of the associated class. May be blank.
optname	The name of the option to set.
arg	The option value to set.

The interpretation of option depends on the associated auxiliary store. See PackedParameters.h for option settings for writing packed data. Returns true on success, false otherwise.

◆ setOption() [6/8]

bool SG::AuxVectorData::setOption	(	const std::string &	name,
		const std::string &	optname,
		double	arg
	)

inherited

◆ setOption() [7/8]

bool SG::AuxVectorData::setOption	(	const std::string &	name,
		const std::string &	optname,
		float	arg
	)

inherited

◆ setOption() [8/8]

bool SG::AuxVectorData::setOption	(	const std::string &	name,
		const std::string &	optname,
		int	arg
	)

inherited

Set an option for an auxiliary data variable.

Parameters

name	The name of the variable.
optname	The name of the option to set.
arg	The option value to set.

The interpretation of option depends on the associated auxiliary store. See PackedParameters.h for option settings for writing packed data. Returns true on success, false otherwise.

◆ setStore() [1/3]

void SG::AuxVectorData::setStore ( const DataLink< SG::IConstAuxStore > & store )

protectedinherited

Set the store associated with this object.

Parameters

store The new store.

This will clear the non-const store pointer, and also clear the cache.

Parameters

The	new store.

This will clear the non-const store pointer, and also clear the cache.

Definition at line 132 of file AuxVectorData.cxx.

 {
   m_store = 0;
   m_constStore = 0;
   m_constStoreLink = store;
   clearCache();
 }

◆ setStore() [2/3]

void SG::AuxVectorData::setStore ( const SG::IConstAuxStore * store )

protectedinherited

Set the store associated with this object.

Parameters

store The new store.

This will clear the non-const store pointer, and also clear the cache.

Parameters

The	new store.

This will clear the non-const store pointer, and also clear the cache.

Definition at line 100 of file AuxVectorData.cxx.

 {
   m_store = 0;
   m_constStore = store;
   m_constStoreLink.clear();
   clearCache();
 }

◆ setStore() [3/3]

void SG::AuxVectorData::setStore ( SG::IAuxStore * store )

protectedinherited

Set the store associated with this object.

Parameters

store The new store.

This will set both the const and non-const store pointers, and also clear the cache.

nb. List the non-const overload before the const one; otherwise, we can't call the const one from python.

Parameters

The	new store.

This will set both the const and non-const store pointers, and also clear the cache.

Definition at line 116 of file AuxVectorData.cxx.

 {
   m_store = store;
   m_constStore = store;
   m_constStoreLink.clear();
   clearCache();
 }

◆ size_v()

virtual size_t SG::AuxVectorInterface::size_v ( ) const

finaloverridevirtual

Return the size of the container.

Implements SG::AuxVectorData.

◆ swap()

void SG::AuxVectorData::swap ( AuxVectorData & other )

inherited

Swap this instance with another.

Parameters

other The other instance with which to swap.

Member Data Documentation

◆ ATLAS_THREAD_SAFE [1/5]

size_t s_minCacheLen SG::AuxVectorData::ATLAS_THREAD_SAFE

staticprotectedinherited

Minimum length to use for the cache vector.

Only changed by unit tests.

Definition at line 593 of file AuxVectorData.h.

◆ ATLAS_THREAD_SAFE [2/5]

Cache m_cache SG::AuxVectorData::ATLAS_THREAD_SAFE

mutableprivateinherited

Cached pointers to the start of aux data vectors, non-const.

Definition at line 963 of file AuxVectorData.h.

◆ ATLAS_THREAD_SAFE [3/5]

Cache m_constCache SG::AuxVectorData::ATLAS_THREAD_SAFE

mutableprivateinherited

Cached pointers to the start of aux data vectors, const.

Definition at line 966 of file AuxVectorData.h.

◆ ATLAS_THREAD_SAFE [4/5]

Cache m_decorCache SG::AuxVectorData::ATLAS_THREAD_SAFE

mutableprivateinherited

Cached pointers to the start of aux data vectors, decorations.

Definition at line 969 of file AuxVectorData.h.

◆ ATLAS_THREAD_SAFE [5/5]

Cache m_spanCache SG::AuxVectorData::ATLAS_THREAD_SAFE

mutableprivateinherited

Cached pointers to span descriptors.

Definition at line 972 of file AuxVectorData.h.

◆ m_constStore

const SG::IConstAuxStore* SG::AuxVectorData::m_constStore

privateinherited

Associated store, const.

Definition at line 980 of file AuxVectorData.h.

◆ m_constStoreLink

DataLink< SG::IConstAuxStore > SG::AuxVectorData::m_constStoreLink

privateinherited

Associated store link, const.

Definition at line 984 of file AuxVectorData.h.

◆ m_mutex

mutex_t SG::AuxVectorData::m_mutex

mutableprivateinherited

Definition at line 990 of file AuxVectorData.h.

◆ m_size

size_t SG::AuxVectorInterface::m_size

private

Size of the container.

Definition at line 81 of file AuxVectorInterface.h.

◆ m_store

SG::IAuxStore* SG::AuxVectorData::m_store

privateinherited

Associated store, non-const.

Definition at line 976 of file AuxVectorData.h.

◆ s_emptySet

const SG::auxid_set_t SG::AuxVectorData::s_emptySet

staticprivateinherited

Empty auxid set, used for a return value when we have no associated store.

Definition at line 993 of file AuxVectorData.h.

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

AuxVectorInterface.h

Public Member Functions

Private Attributes

Aux store management.

Data access.

Other operations.

Detailed Description

Member Typedef Documentation

◆ guard_t

◆ mutex_t

Constructor & Destructor Documentation

◆ AuxVectorInterface() [1/4]

◆ AuxVectorInterface() [2/4]

◆ AuxVectorInterface() [3/4]

◆ AuxVectorInterface() [4/4]

Member Function Documentation

◆ capacity_v()

◆ clearCache() [1/2]

◆ clearCache() [2/2]

◆ clearDecorations()

◆ clearDecorCache()

◆ getAuxIDs()

◆ getConstStore()

◆ getConstStoreLink()

◆ getConstStoreOol()

◆ getData() [1/2]

◆ getData() [2/2]

◆ getDataArray() [1/2]

◆ getDataArray() [2/2]

◆ getDataArrayAllowMissing()

◆ getDataOol() [1/2]

◆ getDataOol() [2/2]

◆ getDataSpan()

◆ getDataSpanOol()

◆ getDecoration()

◆ getDecorationArray()

◆ getDecorationOol()

◆ getDecorIDs()

◆ getStore() [1/2]

◆ getStore() [2/2]

◆ getWritableAuxIDs()

◆ hasNonConstStore()

◆ hasStore()

◆ isAvailable()

◆ isAvailableOol()

◆ isAvailableWritable()

◆ isAvailableWritableAsDecoration()

◆ isAvailableWritableAsDecorationOol()

◆ isAvailableWritableOol()

◆ lock()

◆ lockDecoration()

◆ setCache() [1/2]

◆ setCache() [2/2]

◆ setNonConstStore()

◆ setOption() [1/8]

◆ setOption() [2/8]

◆ setOption() [3/8]

◆ setOption() [4/8]

◆ setOption() [5/8]

◆ setOption() [6/8]

◆ setOption() [7/8]

◆ setOption() [8/8]

◆ setStore() [1/3]

◆ setStore() [2/3]

◆ setStore() [3/3]

◆ size_v()

◆ swap()

Member Data Documentation

◆ ATLAS_THREAD_SAFE [1/5]

◆ ATLAS_THREAD_SAFE [2/5]

◆ ATLAS_THREAD_SAFE [3/5]

◆ ATLAS_THREAD_SAFE [4/5]

◆ ATLAS_THREAD_SAFE [5/5]

◆ m_constStore

◆ m_constStoreLink

◆ m_mutex

◆ m_size

◆ m_store

◆ s_emptySet