Helper class to construct ToolHandle instances for public tools via the auto registering constructor. More...

#include <GaudiKernel/ToolHandle.h>

Inheritance diagram for PublicToolHandle< T >:

[legend]

Collaboration diagram for PublicToolHandle< T >:

[legend]

Public Member Functions
	PublicToolHandle (bool createIf=true)

	PublicToolHandle (const char *toolTypeAndName, bool createIf=true)

	PublicToolHandle (const std::string &toolTypeAndName, bool createIf=true)

template<typename CT = T, typename NCT = typename std::remove_const<T>::type>
	PublicToolHandle (const PublicToolHandle< NCT > &other, typename std::enable_if< std::is_const< CT >::value &&!std::is_same< CT, NCT >::value >::type *=nullptr)
	Copy constructor from a non const T to const T tool handle. More...

template<class OWNER , typename = typename std::enable_if<std::is_base_of<IProperty, OWNER>::value>::type>
	PublicToolHandle (OWNER *owner, std::string name, std::string toolType, std::string doc="")
	Autodeclaring constructor with property name, tool type/name and documentation. More...

Public Member Functions inherited from ToolHandle< T >
	ToolHandle (const IInterface *parent=nullptr, bool createIf=true)
	Constructor for a tool with default tool type and name. More...

template<typename CT = T, typename NCT = typename std::remove_const<T>::type>
	ToolHandle (const ToolHandle< NCT > &other, typename std::enable_if< std::is_const< CT >::value &&!std::is_same< CT, NCT >::value >::type *=nullptr)
	Copy constructor from a non const T to const T tool handle. More...

	ToolHandle (const std::string &toolTypeAndName, const IInterface *parent=nullptr, bool createIf=true)
	Create a handle ('smart pointer') to a tool. More...

template<class OWNER , typename = typename std::enable_if<std::is_base_of<IProperty, OWNER>::value>::type>
	ToolHandle (OWNER *owner, std::string name, std::string toolType, std::string doc="")
	Autodeclaring constructor with property name, tool type/name and documentation. More...

StatusCode	initialize (const std::string &toolTypeAndName, const IInterface *parent=nullptr, bool createIf=true)

StatusCode	retrieve () const
	Retrieve the AlgTool. More...

StatusCode	release () const
	Release the AlgTool. More...

StatusCode	retrieve (T *&algTool) const override
	Do the real retrieval of the AlgTool. More...

StatusCode	release (T *algTool) const override
	Do the real release of the AlgTool. More...

std::string	typeAndName () const override

std::add_const< T >::type *	get () const

T *	get ()

Public Member Functions inherited from BaseToolHandle
StatusCode	retrieve (IAlgTool *&tool) const

const IAlgTool *	get () const

IAlgTool *	get ()

Public Member Functions inherited from ToolHandleInfo
virtual	~ToolHandleInfo ()=default

bool	isPublic () const noexcept

bool	createIf () const noexcept

const IInterface *	parent () const noexcept

Public Member Functions inherited from GaudiHandle< T >
template<typename CT = T, typename NCT = typename std::remove_const<T>::type>
	GaudiHandle (const GaudiHandle< NCT > &other, typename std::enable_if< std::is_const< CT >::value &&!std::is_same< CT, NCT >::value >::type *=nullptr)
	Copy constructor needed for correct ref-counting. More...

	GaudiHandle (const GaudiHandle &other)
	Copy constructor needed for correct ref-counting. More...

template<typename CT = T, typename NCT = typename std::remove_const<T>::type>
std::enable_if< std::is_const< CT >::value &&!std::is_same< CT, NCT >::value, GaudiHandle & >::type	operator= (const GaudiHandle< NCT > &other)
	Assignment operator for correct ref-counting. More...

GaudiHandle &	operator= (const GaudiHandle &other)
	Assignment operator for correct ref-counting. More...

StatusCode	retrieve () const
	Retrieve the component. More...

StatusCode	release () const
	Release the component. More...

bool	isValid () const
	Check if the handle is valid (try to retrive the object is not done yet). More...

	operator bool () const
	For testing if handle has component. More...

T *	get ()
	Return the wrapped pointer, not calling retrieve() if null. More...

std::add_const< T >::type *	get () const
	Return the wrapped pointer, not calling retrieve() if null. More...

bool	isSet () const
	True if the wrapped pointer is not null. More...

T &	operator* ()

T *	operator-> ()

std::add_const< T >::type &	operator* () const

std::add_const< T >::type *	operator-> () const

std::string	getDefaultType ()
	Helper function to get default type string from the class type. More...

std::string	getDefaultName ()

Public Member Functions inherited from GaudiHandleBase
std::string	typeAndName () const
	The full type and name: "type/name". More...

std::string	type () const
	The concrete component class name: the part before the '/'. More...

std::string	name () const
	The instance name: the part after the '/'. More...

bool	empty () const
	Check if the handle has been set to empty string (i.e. More...

void	setTypeAndName (std::string myTypeAndName)
	The component "type/name" string. More...

void	setName (const std::string &myName)
	Set the instance name (part after the '/') without changing the class type. More...

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

std::string	messageName () const
	name used for printing messages More...

std::string	pythonRepr () const override
	Python representation of handle, i.e. 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...

Additional Inherited Members
Static Public Member Functions inherited from ToolHandleInfo
static std::string	toolComponentType (const IInterface *parent)

static std::string	toolParentName (const IInterface *parent)

Protected Member Functions inherited from ToolHandle< T >
const IAlgTool *	getAsIAlgTool () const override

IAlgTool *	getAsIAlgTool () override

StatusCode	i_retrieve (IAlgTool *&algTool) const override

Protected Member Functions inherited from BaseToolHandle
	BaseToolHandle (const IInterface *parent=nullptr, bool createIf=true)

Protected Member Functions inherited from ToolHandleInfo
	ToolHandleInfo (const IInterface *parent=nullptr, bool createIf=true)

Protected Member Functions inherited from GaudiHandle< T >
	GaudiHandle (std::string myTypeAndName, std::string myComponentType, std::string myParentName)

template<class CLASS >
std::remove_const< CLASS >::type *	nonConst (CLASS *p) const
	Cast a pointer to a non const type. More...

Protected Member Functions inherited from GaudiHandleBase
	GaudiHandleBase (std::string myTypeAndName, std::string myComponentType, std::string myParentName)
	Create a handle ('smart pointer') to a gaudi component. More...

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 (const std::string &componentType)
	The component type. More...

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

Protected Attributes inherited from ToolHandleInfo
const IInterface *	m_parent = nullptr

bool	m_createIf {true}

Detailed Description

template<class T>
class PublicToolHandle< T >

Helper class to construct ToolHandle instances for public tools via the auto registering constructor.

Definition at line 275 of file ToolHandle.h.

Constructor & Destructor Documentation

template<class T>

PublicToolHandle< T >::PublicToolHandle ( bool createIf = true )

inline

Definition at line 278 of file ToolHandle.h.

278 : ToolHandle<T>( nullptr, createIf ) {}

ToolHandle

Handle to be used in lieu of naked pointers to tools.

Definition: PropertyHolder.h:30

ToolHandleInfo::createIf

bool createIf() const noexcept

Definition: ToolHandle.h:39

template<class T>

PublicToolHandle< T >::PublicToolHandle	(	const char *	toolTypeAndName,
		bool	createIf = `true`
	)

inline

Definition at line 279 of file ToolHandle.h.

       : PublicToolHandle{std::string{toolTypeAndName}, createIf}
   {
   }

template<class T>

PublicToolHandle< T >::PublicToolHandle	(	const std::string &	toolTypeAndName,
		bool	createIf = `true`
	)

inline

Definition at line 283 of file ToolHandle.h.

       : ToolHandle<T>( toolTypeAndName, nullptr, createIf )
   {
   }

template<class T>

template<typename CT = T, typename NCT = typename std::remove_const<T>::type>

PublicToolHandle< T >::PublicToolHandle	(	const PublicToolHandle< NCT > &	other,
		typename std::enable_if< std::is_const< CT >::value &&!std::is_same< CT, NCT >::value >::type *	= `nullptr`
	)

inline

Copy constructor from a non const T to const T tool handle.

Definition at line 290 of file ToolHandle.h.

       : ToolHandle<T>( static_cast<const ToolHandle<NCT>&>( other ) )
   {
   }

template<class T>

template<class OWNER , typename = typename std::enable_if<std::is_base_of<IProperty, OWNER>::value>::type>

PublicToolHandle< T >::PublicToolHandle	(	OWNER *	owner,
		std::string	name,
		std::string	toolType,
		std::string	doc = `""`
	)

inline

Autodeclaring constructor with property name, tool type/name and documentation.

Note: the use std::enable_if is required to avoid ambiguities

Definition at line 300 of file ToolHandle.h.

       : PublicToolHandle()
   {
     // convert name and type to a valid type/name string
     // - if type does not contain '/' use type/name
     // - otherwise type is already a type/name string
     if ( !toolType.empty() and toolType.find( '/' ) == std::string::npos ) {
       toolType += '/';
       toolType += name;
     }
     owner->declareTool( *this, std::move( toolType ) ).ignore();
     auto p = owner->OWNER::PropertyHolderImpl::declareProperty( std::move( name ), *this, std::move( doc ) );
     p->template setOwnerType<OWNER>();
   }

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

GaudiKernel/GaudiKernel/ToolHandle.h

Public Member Functions

Additional Inherited Members

Detailed Description

template<class T> class PublicToolHandle< T >

Constructor & Destructor Documentation

template<class T>
class PublicToolHandle< T >