T is the concrete handle type, e.g. More...

#include <GaudiKernel/GaudiHandle.h>

Inheritance diagram for GaudiHandleArray< T >:

Collaboration diagram for GaudiHandleArray< T >:

[legend]

Public Types
typedef std::vector< T >	HandleVector

typedef HandleVector::value_type	value_type

typedef HandleVector::size_type	size_type

typedef HandleVector::reference	reference

typedef HandleVector::const_reference	const_reference

typedef HandleVector::iterator	iterator

typedef HandleVector::const_iterator	const_iterator

typedef HandleVector::reverse_iterator	reverse_iterator

typedef HandleVector::const_reverse_iterator	const_reverse_iterator

Public Types inherited from GaudiHandleArrayBase
using	PropertyType = GaudiHandleArrayProperty

typedef std::vector< GaudiHandleBase * >	BaseHandleArray

typedef std::vector< const GaudiHandleBase * >	ConstBaseHandleArray

Public Member Functions
GaudiHandleArray &	operator= (const std::vector< std::string > &myTypesAndNamesList)
	Set the array of GaudiHandles from typeAndNames given in vector of strings. More...

GaudiHandleArrayBase::BaseHandleArray	getBaseArray () override
	Get a read-write vector of GaudiHandleBase* pointing to the real handles. More...

GaudiHandleArrayBase::ConstBaseHandleArray	getBaseArray () const override
	Get a read-only vector of const GaudiHandleBase* pointing to the real handles. More...

iterator	begin ()

iterator	end ()

const_iterator	begin () const

const_iterator	end () const

const_iterator	rbegin () const

const_iterator	rend () const

size_type	size () const

void	clear () override
	Clear the list of handles. More...

bool	empty () const override
	Return whether the list of tools is empty. More...

T &	operator[] (int index)

const T &	operator[] (int index) const

T *	operator[] (std::string_view name)
	Get pointer (!) to ToolHandle by instance name. More...

const T *	operator[] (std::string_view name) const
	Get const pointer (!) to ToolHandle by instance name. More...

virtual bool	push_back (const T &myHandle)

StatusCode	retrieve ()
	Retrieve all tools. More...

StatusCode	release ()
	Release all tools. More...

virtual bool	retrieved () const override
	has Array been retreived? More...

virtual bool	push_back (const std::string &myHandleTypeAndName)=0
	Add a handle with given type and name. More...

Public Member Functions inherited from GaudiHandleArrayBase
bool	setTypesAndNames (const std::vector< std::string > &myTypesAndNamesList)
	Set the array of handles from list of "type/name" strings in <myTypesAndNamesList>. More...

const std::vector< std::string >	typesAndNames () const
	Return a vector with "type/name" strings of all handles in the array. More...

const std::vector< std::string >	types () const
	Return a vector with "type" strings of all handles in the array. More...

const std::vector< std::string >	names () const
	Return a vector with "type/name" strings of all handles in the array. More...

const std::vector< std::string >	getBaseInfos (std::string(GaudiHandleBase::*pMemFunc)() const) const
	Helper function to get a vector of strings filled with the return value of each tool of a member function if GaudiHandleBase. More...

std::string	pythonPropertyClassName () const override
	Name of the componentType with "HandleArray" appended. More...

std::string	pythonRepr () const override
	Python representation of array of handles, i.e. More...

virtual bool	push_back (const std::string &myHandleTypeAndName)=0
	Add a handle to the array with "type/name" given in <myHandleTypeAndName>. More...

Public Member Functions inherited from GaudiHandleInfo
virtual	~GaudiHandleInfo ()=default
	virtual destructor so that derived class destructor is called. More...

const std::string &	componentType () const

const std::string &	propertyName () const
	name as used in declareProperty(name,gaudiHandle) More...

void	setPropertyName (std::string propName)
	set name as used in declareProperty(name,gaudiHandle). More...

const std::string &	parentName () const
	The name of the parent. More...

Protected Member Functions
	GaudiHandleArray (const std::vector< std::string > &myTypesAndNamesList, std::string myComponentType, std::string myParentName)
	Generic constructor. More...

	GaudiHandleArray (const std::string &myComponentType, const std::string &myParentName)
	Constructor creating an empty array. More...

Protected Member Functions inherited from GaudiHandleArrayBase
	GaudiHandleArrayBase (std::string myComponentType, std::string myParentName)

Protected Member Functions inherited from GaudiHandleInfo
	GaudiHandleInfo (std::string myComponentType, std::string myParentName)
	Some basic information and helper functions shared between various handles/arrays. More...

void	setComponentType (std::string componentType)
	The component type. More...

void	setParentName (std::string parent)
	The name of the parent. More...

Private Attributes
HandleVector	m_handleArray

bool	m_retrieved {false}

Detailed Description

template<class T>
class GaudiHandleArray< T >

T is the concrete handle type, e.g.

ToolHandle<IMyTool>

Definition at line 403 of file GaudiHandle.h.

Member Typedef Documentation

◆ const_iterator

template<class T>

typedef HandleVector::const_iterator GaudiHandleArray< T >::const_iterator

Definition at line 414 of file GaudiHandle.h.

◆ const_reference

template<class T>

typedef HandleVector::const_reference GaudiHandleArray< T >::const_reference

Definition at line 412 of file GaudiHandle.h.

◆ const_reverse_iterator

template<class T>

typedef HandleVector::const_reverse_iterator GaudiHandleArray< T >::const_reverse_iterator

Definition at line 416 of file GaudiHandle.h.

◆ HandleVector

template<class T>

typedef std::vector<T> GaudiHandleArray< T >::HandleVector

Definition at line 408 of file GaudiHandle.h.

◆ iterator

template<class T>

typedef HandleVector::iterator GaudiHandleArray< T >::iterator

Definition at line 413 of file GaudiHandle.h.

◆ reference

template<class T>

typedef HandleVector::reference GaudiHandleArray< T >::reference

Definition at line 411 of file GaudiHandle.h.

◆ reverse_iterator

template<class T>

typedef HandleVector::reverse_iterator GaudiHandleArray< T >::reverse_iterator

Definition at line 415 of file GaudiHandle.h.

◆ size_type

template<class T>

typedef HandleVector::size_type GaudiHandleArray< T >::size_type

Definition at line 410 of file GaudiHandle.h.

◆ value_type

template<class T>

typedef HandleVector::value_type GaudiHandleArray< T >::value_type

Definition at line 409 of file GaudiHandle.h.

Constructor & Destructor Documentation

◆ GaudiHandleArray() [1/2]

template<class T>

GaudiHandleArray< T >::GaudiHandleArray	(	const std::vector< std::string > &	myTypesAndNamesList,
		std::string	myComponentType,
		std::string	myParentName
	)

inlineprotected

Generic constructor.

Probably not very useful...

Parameters

typesAndNamesList : a vector of strings with the concrete "type/name" strings for the list of tools

Definition at line 426 of file GaudiHandle.h.

       : GaudiHandleArrayBase( std::move( myComponentType ), std::move( myParentName ) ) {
     setTypesAndNames( myTypesAndNamesList );
   }

◆ GaudiHandleArray() [2/2]

template<class T>

GaudiHandleArray< T >::GaudiHandleArray	(	const std::string &	myComponentType,
		const std::string &	myParentName
	)

inlineprotected

Constructor creating an empty array.

Parameters

typesAndNamesList : a vector of strings with the concrete "type/name" strings for the list of tools

Definition at line 436 of file GaudiHandle.h.

437 : GaudiHandleArrayBase( myComponentType, myParentName ) {}

GaudiHandleArrayBase::GaudiHandleArrayBase

GaudiHandleArrayBase(std::string myComponentType, std::string myParentName)

Definition: GaudiHandle.h:342

Member Function Documentation

◆ begin() [1/2]

template<class T>

iterator GaudiHandleArray< T >::begin ( )

inline

Definition at line 461 of file GaudiHandle.h.

461 { return m_handleArray.begin(); }

GaudiHandleArray::m_handleArray

HandleVector m_handleArray

Definition: GaudiHandle.h:534

std::vector::begin

T begin(T... args)

◆ begin() [2/2]

template<class T>

const_iterator GaudiHandleArray< T >::begin ( ) const

inline

Definition at line 465 of file GaudiHandle.h.

465 { return m_handleArray.begin(); }

GaudiHandleArray::m_handleArray

HandleVector m_handleArray

Definition: GaudiHandle.h:534

std::vector::begin

T begin(T... args)

◆ clear()

template<class T>

void GaudiHandleArray< T >::clear ( )

inlineoverridevirtual

Clear the list of handles.

Implemented in GaudiHandleArray

Implements GaudiHandleArrayBase.

Definition at line 475 of file GaudiHandle.h.

475 { m_handleArray.clear(); }

GaudiHandleArray::m_handleArray

HandleVector m_handleArray

Definition: GaudiHandle.h:534

std::vector::clear

T clear(T... args)

◆ empty()

template<class T>

bool GaudiHandleArray< T >::empty ( ) const

inlineoverridevirtual

Return whether the list of tools is empty.

Implements GaudiHandleArrayBase.

Definition at line 477 of file GaudiHandle.h.

477 { return m_handleArray.empty(); }

std::vector::empty

T empty(T... args)

GaudiHandleArray::m_handleArray

HandleVector m_handleArray

Definition: GaudiHandle.h:534

◆ end() [1/2]

template<class T>

iterator GaudiHandleArray< T >::end ( )

inline

Definition at line 463 of file GaudiHandle.h.

463 { return m_handleArray.end(); }

std::vector::end

T end(T... args)

GaudiHandleArray::m_handleArray

HandleVector m_handleArray

Definition: GaudiHandle.h:534

◆ end() [2/2]

template<class T>

const_iterator GaudiHandleArray< T >::end ( ) const

inline

Definition at line 467 of file GaudiHandle.h.

467 { return m_handleArray.end(); }

std::vector::end

T end(T... args)

GaudiHandleArray::m_handleArray

HandleVector m_handleArray

Definition: GaudiHandle.h:534

◆ getBaseArray() [1/2]

template<class T>

GaudiHandleArrayBase::BaseHandleArray GaudiHandleArray< T >::getBaseArray ( )

inlineoverridevirtual

Get a read-write vector of GaudiHandleBase* pointing to the real handles.

Implemented in GaudiHandleArray.

Implements GaudiHandleArrayBase.

Definition at line 446 of file GaudiHandle.h.

                                                               {
     GaudiHandleArrayBase::BaseHandleArray baseArray;
     for ( auto& h : m_handleArray ) baseArray.push_back( &h );
     return baseArray;
   }

◆ getBaseArray() [2/2]

template<class T>

GaudiHandleArrayBase::ConstBaseHandleArray GaudiHandleArray< T >::getBaseArray ( ) const

inlineoverridevirtual

Get a read-only vector of const GaudiHandleBase* pointing to the real handles.

Implemented in GaudiHandleArray.

Implements GaudiHandleArrayBase.

Definition at line 452 of file GaudiHandle.h.

                                                                          {
     GaudiHandleArrayBase::ConstBaseHandleArray baseArray;
     for ( auto& h : m_handleArray ) baseArray.push_back( &h );
     return baseArray;
   }

◆ operator=()

template<class T>

GaudiHandleArray& GaudiHandleArray< T >::operator= ( const std::vector< std::string > & myTypesAndNamesList )

inline

Set the array of GaudiHandles from typeAndNames given in vector of strings.

Definition at line 441 of file GaudiHandle.h.

                                                                                  {
     setTypesAndNames( myTypesAndNamesList );
     return *this;
   }

◆ operator[]() [1/4]

template<class T>

T& GaudiHandleArray< T >::operator[] ( int index )

inline

Definition at line 479 of file GaudiHandle.h.

479 { return m_handleArray[index]; }

GaudiHandleArray::m_handleArray

HandleVector m_handleArray

Definition: GaudiHandle.h:534

◆ operator[]() [2/4]

template<class T>

const T& GaudiHandleArray< T >::operator[] ( int index ) const

inline

Definition at line 481 of file GaudiHandle.h.

481 { return m_handleArray[index]; }

GaudiHandleArray::m_handleArray

HandleVector m_handleArray

Definition: GaudiHandle.h:534

◆ operator[]() [3/4]

template<class T>

T* GaudiHandleArray< T >::operator[] ( std::string_view name )

inline

Get pointer (!) to ToolHandle by instance name.

Returns zero pointer if not found

Definition at line 484 of file GaudiHandle.h.

                                        {
     auto it = std::find_if( begin(), end(), [&]( const_reference r ) { return r.name() == name; } );
     return it != end() ? &*it : nullptr;
   }

◆ operator[]() [4/4]

template<class T>

const T* GaudiHandleArray< T >::operator[] ( std::string_view name ) const

inline

Get const pointer (!) to ToolHandle by instance name.

Returns zero pointer if not found

Definition at line 490 of file GaudiHandle.h.

                                                    {
     auto it = std::find_if( begin(), end(), [&]( const_reference r ) { return r.name() == name; } );
     return it != end() ? &*it : nullptr;
   }

◆ push_back() [1/2]

template<class T>

virtual bool GaudiHandleArrayBase::push_back

Add a handle with given type and name.

Can be overridden in derived class. Return whether addition was successful or not.

◆ push_back() [2/2]

template<class T>

virtual bool GaudiHandleArray< T >::push_back ( const T & myHandle )

inlinevirtual

Reimplemented in ToolHandleArray< T >, ToolHandleArray< IThreadInitTool >, and ServiceHandleArray< T >.

Definition at line 498 of file GaudiHandle.h.

                                               {
     m_handleArray.push_back( myHandle );
     return true;
   }

◆ rbegin()

template<class T>

const_iterator GaudiHandleArray< T >::rbegin ( ) const

inline

Definition at line 469 of file GaudiHandle.h.

469 { return m_handleArray.rbegin(); }

GaudiHandleArray::m_handleArray

HandleVector m_handleArray

Definition: GaudiHandle.h:534

std::vector::rbegin

T rbegin(T... args)

◆ release()

template<class T>

StatusCode GaudiHandleArray< T >::release ( )

inline

Release all tools.

Definition at line 518 of file GaudiHandle.h.

                        {
     StatusCode sc = StatusCode::SUCCESS;
     for ( auto& i : *this ) {
       // continue trying to release other tools even if we fail...
       if ( i.release().isFailure() ) sc = StatusCode::FAILURE;
     }
     return sc;
   }

◆ rend()

template<class T>

const_iterator GaudiHandleArray< T >::rend ( ) const

inline

Definition at line 471 of file GaudiHandle.h.

471 { return m_handleArray.rend(); }

std::vector::rend

T rend(T... args)

GaudiHandleArray::m_handleArray

HandleVector m_handleArray

Definition: GaudiHandle.h:534

◆ retrieve()

template<class T>

StatusCode GaudiHandleArray< T >::retrieve ( )

inline

Retrieve all tools.

Definition at line 504 of file GaudiHandle.h.

                         {
     StatusCode sc = StatusCode::SUCCESS;
     for ( auto& i : *this ) {
       // stop at first failure
       if ( i.retrieve().isFailure() ) {
         sc = StatusCode::FAILURE;
         break;
       }
     }
     if ( sc ) { m_retrieved = true; }
     return sc;
   }

◆ retrieved()

template<class T>

virtual bool GaudiHandleArray< T >::retrieved ( ) const

inlineoverridevirtual

has Array been retreived?

Implements GaudiHandleArrayBase.

Definition at line 528 of file GaudiHandle.h.

528 { return m_retrieved; }

GaudiHandleArray::m_retrieved

bool m_retrieved

Definition: GaudiHandle.h:535

◆ size()

template<class T>

size_type GaudiHandleArray< T >::size ( ) const

inline

Definition at line 473 of file GaudiHandle.h.

473 { return m_handleArray.size(); }

GaudiHandleArray::m_handleArray

HandleVector m_handleArray

Definition: GaudiHandle.h:534

std::vector::size

T size(T... args)

Member Data Documentation

◆ m_handleArray

template<class T>

HandleVector GaudiHandleArray< T >::m_handleArray

private

Definition at line 534 of file GaudiHandle.h.

◆ m_retrieved

template<class T>

bool GaudiHandleArray< T >::m_retrieved {false}

private

Definition at line 535 of file GaudiHandle.h.

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

GaudiKernel/GaudiKernel/GaudiHandle.h

Public Types

Public Member Functions

Protected Member Functions

Private Attributes

Detailed Description

template<class T> class GaudiHandleArray< T >

Member Typedef Documentation

◆ const_iterator

◆ const_reference

◆ const_reverse_iterator

◆ HandleVector

◆ iterator

◆ reference

◆ reverse_iterator

◆ size_type

◆ value_type

Constructor & Destructor Documentation

◆ GaudiHandleArray() [1/2]

◆ GaudiHandleArray() [2/2]

Member Function Documentation

◆ begin() [1/2]

◆ begin() [2/2]

◆ clear()

◆ empty()

◆ end() [1/2]

◆ end() [2/2]

◆ getBaseArray() [1/2]

◆ getBaseArray() [2/2]

◆ operator=()

◆ operator[]() [1/4]

◆ operator[]() [2/4]

◆ operator[]() [3/4]

◆ operator[]() [4/4]

◆ push_back() [1/2]

◆ push_back() [2/2]

◆ rbegin()

◆ release()

◆ rend()

◆ retrieve()

◆ retrieved()

◆ size()

Member Data Documentation

◆ m_handleArray

◆ m_retrieved

template<class T>
class GaudiHandleArray< T >