Implements the common functionality between GaudiTools and GaudiAlgorithms. More...

#include <GaudiAlg/GaudiCommon.h>

Inheritance diagram for GaudiCommon< PBASE >:

Collaboration diagram for GaudiCommon< PBASE >:

Public Member Functions
template<class TYPE >
Gaudi::Utils::GetData< TYPE >::return_type	get (IDataProviderSvc *svc, const std::string &location, const bool useRootInTES=true) const
	Templated access to the data in Gaudi Transient Store. More...

template<class TYPE >
Gaudi::Utils::GetData< TYPE >::return_type	getIfExists (IDataProviderSvc *svc, const std::string &location, const bool useRootInTES=true) const
	Quicker version of the get function which bypasses the check on the retrieved data. More...

template<class TYPE >
bool	exist (IDataProviderSvc *svc, const std::string &location, const bool useRootInTES=true) const
	Check the existence of a data object or container in the Gaudi Transient Event Store. More...

template<class TYPE , class TYPE2 >
Gaudi::Utils::GetData< TYPE >::return_type	getOrCreate (IDataProviderSvc *svc, const std::string &location, const bool useRootInTES=true) const
	Get the existing data object from Gaudi Event Transient store. More...

DataObject *	put (IDataProviderSvc svc, DataObject object, const std::string &location, const bool useRootInTES=true) const
	Register a data object or container into Gaudi Event Transient Store. More...

template<class TOOL >
TOOL *	tool (const std::string &type, const std::string &name, const IInterface *parent=0, bool create=true) const
	Useful method for the easy location of tools. More...

template<class TOOL >
TOOL *	tool (const std::string &type, const IInterface *parent=0, bool create=true) const
	A useful method for the easy location of tools. More...

template<class SERVICE >
SmartIF< SERVICE >	svc (const std::string &name, const bool create=true) const
	A useful method for the easy location of services. More...

IUpdateManagerSvc *	updMgrSvc () const
	Short-cut to locate the Update Manager Service. More...

StatusCode	Error (const std::string &msg, const StatusCode st=StatusCode::FAILURE, const size_t mx=10) const
	Print the error message and return with the given StatusCode. More...

StatusCode	Warning (const std::string &msg, const StatusCode st=StatusCode::FAILURE, const size_t mx=10) const
	Print the warning message and return with the given StatusCode. More...

StatusCode	Info (const std::string &msg, const StatusCode st=StatusCode::SUCCESS, const size_t mx=10) const
	Print the info message and return with the given StatusCode. More...

StatusCode	Print (const std::string &msg, const StatusCode st=StatusCode::SUCCESS, const MSG::Level lev=MSG::INFO) const
	Print the message and return with the given StatusCode. More...

void	Assert (const bool ok, const std::string &message="", const StatusCode sc=StatusCode(StatusCode::FAILURE, true)) const
	Assertion - throw exception if the given condition is not fulfilled. More...

void	Assert (const bool ok, const char *message, const StatusCode sc=StatusCode(StatusCode::FAILURE, true)) const
	Assertion - throw exception if the given condition is not fulfilled. More...

void	Exception (const std::string &msg, const GaudiException &exc, const StatusCode sc=StatusCode(StatusCode::FAILURE, true)) const
	Create and (re)-throw a given GaudiException. More...

void	Exception (const std::string &msg, const std::exception &exc, const StatusCode sc=StatusCode(StatusCode::FAILURE, true)) const
	Create and (re)-throw a given exception. More...

void	Exception (const std::string &msg="no message", const StatusCode sc=StatusCode(StatusCode::FAILURE, true)) const
	Create and throw an exception with the given message. More...

const Statistics &	counters () const
	accessor to all counters More...

StatEntity &	counter (const std::string &tag) const
	accessor to certain counter by name More...

void	resetMsgStream () const

bool	typePrint () const
	Insert the actual C++ type of the algorithm/tool in the messages ? More...

bool	propsPrint () const
	Print properties at initialization ? More...

bool	statPrint () const
	Print statistical counters at finalization ? More...

bool	errorsPrint () const
	Print error counters at finalization ? More...

long	printStat (const MSG::Level level=MSG::ALWAYS) const
	perform the actual printout of statistical counters More...

long	printErrors (const MSG::Level level=MSG::ALWAYS) const
	perform the actual printout of error counters More...

long	printProps (const MSG::Level level=MSG::ALWAYS) const
	perform the actual printout of properties More...

template<class CallerClass >
void	registerCondition (const std::string &condition, StatusCode(CallerClass::*mf)()=nullptr)
	register the current instance to the UpdateManagerSvc as a consumer for a condition. More...

template<class CallerClass , class CondType >
void	registerCondition (const std::string &condition, CondType &condPtrDest, StatusCode(CallerClass::mf)()=NULL)
	register the current instance to the UpdateManagerSvc as a consumer for a condition. More...

template<class CallerClass >
void	registerCondition (char condition, StatusCode(CallerClass::mf)()=NULL)
	just to avoid conflicts with the version using a pointer to a template class. More...

template<class CallerClass , class TargetClass >
void	registerCondition (TargetClass condition, StatusCode(CallerClass::mf)()=NULL)
	register the current instance to the UpdateManagerSvc as a consumer for a condition. More...

StatusCode	runUpdate ()
	asks the UpdateManagerSvc to perform an update of the instance (if needed) without waiting the next BeginEvent incident. More...

	GaudiCommon (const std::string &name, ISvcLocator *pSvcLocator)
	Algorithm constructor. More...

	GaudiCommon (const std::string &type, const std::string &name, const IInterface *parent)
	Tool constructor. More...

StatusCode	initialize () override
	standard initialization method More...

StatusCode	finalize () override
	standard finalization method More...

StatusCode	release (const IInterface *interface) const
	Manual forced (and 'safe') release of the active tool or service. More...

const AlgTools &	tools () const
	get the list of aquired tools More...

const Services &	services () const
	get the list of aquired services More...

const std::string &	context () const
	Returns the "context" string. Used to identify different processing states. More...

const std::string &	rootInTES () const
	Returns the "rootInTES" string. More...

double	globalTimeOffset () const
	Returns the "globalTimeOffset" double. More...

const std::string	fullTESLocation (const std::string &location, const bool useRootInTES) const
	Returns the full correct event location given the rootInTes settings. More...

template<class TYPE >
Gaudi::Utils::GetData< TYPE >::return_type	get (IDataProviderSvc *svc, const std::string &location, const bool useRootInTES=true) const
	Templated access to the data in Gaudi Transient Store. More...

template<class TYPE >
Gaudi::Utils::GetData< TYPE >::return_type	getIfExists (IDataProviderSvc *svc, const std::string &location, const bool useRootInTES=true) const
	Quicker version of the get function which bypasses the check on the retrieved data. More...

template<class TYPE >
bool	exist (IDataProviderSvc *svc, const std::string &location, const bool useRootInTES=true) const
	Check the existence of a data object or container in the Gaudi Transient Event Store. More...

template<class TYPE , class TYPE2 >
Gaudi::Utils::GetData< TYPE >::return_type	getOrCreate (IDataProviderSvc *svc, const std::string &location, const bool useRootInTES=true) const
	Get the existing data object from Gaudi Event Transient store. More...

DataObject *	put (IDataProviderSvc svc, DataObject object, const std::string &location, const bool useRootInTES=true) const
	Register a data object or container into Gaudi Event Transient Store. More...

template<class TOOL >
TOOL *	tool (const std::string &type, const std::string &name, const IInterface *parent=0, bool create=true) const
	Useful method for the easy location of tools. More...

template<class TOOL >
TOOL *	tool (const std::string &type, const IInterface *parent=0, bool create=true) const
	A useful method for the easy location of tools. More...

template<class SERVICE >
SmartIF< SERVICE >	svc (const std::string &name, const bool create=true) const
	A useful method for the easy location of services. More...

IUpdateManagerSvc *	updMgrSvc () const
	Short-cut to locate the Update Manager Service. More...

StatusCode	Error (const std::string &msg, const StatusCode st=StatusCode::FAILURE, const size_t mx=10) const
	Print the error message and return with the given StatusCode. More...

StatusCode	Warning (const std::string &msg, const StatusCode st=StatusCode::FAILURE, const size_t mx=10) const
	Print the warning message and return with the given StatusCode. More...

StatusCode	Info (const std::string &msg, const StatusCode st=StatusCode::SUCCESS, const size_t mx=10) const
	Print the info message and return with the given StatusCode. More...

StatusCode	Print (const std::string &msg, const StatusCode st=StatusCode::SUCCESS, const MSG::Level lev=MSG::INFO) const
	Print the message and return with the given StatusCode. More...

void	Assert (const bool ok, const std::string &message="", const StatusCode sc=StatusCode(StatusCode::FAILURE, true)) const
	Assertion - throw exception if the given condition is not fulfilled. More...

void	Assert (const bool ok, const char *message, const StatusCode sc=StatusCode(StatusCode::FAILURE, true)) const
	Assertion - throw exception if the given condition is not fulfilled. More...

void	Exception (const std::string &msg, const GaudiException &exc, const StatusCode sc=StatusCode(StatusCode::FAILURE, true)) const
	Create and (re)-throw a given GaudiException. More...

void	Exception (const std::string &msg, const std::exception &exc, const StatusCode sc=StatusCode(StatusCode::FAILURE, true)) const
	Create and (re)-throw a given exception. More...

void	Exception (const std::string &msg="no message", const StatusCode sc=StatusCode(StatusCode::FAILURE, true)) const
	Create and throw an exception with the given message. More...

const Statistics &	counters () const
	accessor to all counters More...

StatEntity &	counter (const std::string &tag) const
	accessor to certain counter by name More...

void	resetMsgStream () const

bool	typePrint () const
	Insert the actual C++ type of the algorithm/tool in the messages ? More...

bool	propsPrint () const
	Print properties at initialization ? More...

bool	statPrint () const
	Print statistical counters at finalization ? More...

bool	errorsPrint () const
	Print error counters at finalization ? More...

long	printStat (const MSG::Level level=MSG::ALWAYS) const
	perform the actual printout of statistical counters More...

long	printErrors (const MSG::Level level=MSG::ALWAYS) const
	perform the actual printout of error counters More...

long	printProps (const MSG::Level level=MSG::ALWAYS) const
	perform the actual printout of properties More...

template<class CallerClass >
void	registerCondition (const std::string &condition, StatusCode(CallerClass::*mf)()=nullptr)
	register the current instance to the UpdateManagerSvc as a consumer for a condition. More...

template<class CallerClass , class CondType >
void	registerCondition (const std::string &condition, CondType &condPtrDest, StatusCode(CallerClass::mf)()=NULL)
	register the current instance to the UpdateManagerSvc as a consumer for a condition. More...

template<class CallerClass >
void	registerCondition (char condition, StatusCode(CallerClass::mf)()=NULL)
	just to avoid conflicts with the version using a pointer to a template class. More...

template<class CallerClass , class TargetClass >
void	registerCondition (TargetClass condition, StatusCode(CallerClass::mf)()=NULL)
	register the current instance to the UpdateManagerSvc as a consumer for a condition. More...

StatusCode	runUpdate ()
	asks the UpdateManagerSvc to perform an update of the instance (if needed) without waiting the next BeginEvent incident. More...

	GaudiCommon (const std::string &name, ISvcLocator *pSvcLocator)
	Algorithm constructor. More...

	GaudiCommon (const std::string &type, const std::string &name, const IInterface *parent)
	Tool constructor. More...

StatusCode	initialize () override
	standard initialization method More...

StatusCode	finalize () override
	standard finalization method More...

StatusCode	release (const IInterface *interface) const
	Manual forced (and 'safe') release of the active tool or service. More...

const AlgTools &	tools () const
	get the list of aquired tools More...

const Services &	services () const
	get the list of aquired services More...

const std::string &	context () const
	Returns the "context" string. Used to identify different processing states. More...

const std::string &	rootInTES () const
	Returns the "rootInTES" string. More...

double	globalTimeOffset () const
	Returns the "globalTimeOffset" double. More...

const std::string	fullTESLocation (const std::string &location, const bool useRootInTES) const
	Returns the full correct event location given the rootInTes settings. More...

template<class TYPE >
Gaudi::Utils::GetData< TYPE >::return_type	get (IDataProviderSvc *service, const std::string &location, const bool useRootInTES) const

template<class TYPE >
Gaudi::Utils::GetData< TYPE >::return_type	getIfExists (IDataProviderSvc *service, const std::string &location, const bool useRootInTES) const

template<class TYPE , class TYPE2 >
Gaudi::Utils::GetData< TYPE >::return_type	getOrCreate (IDataProviderSvc *service, const std::string &location, const bool useRootInTES) const

template<class TYPE >
Gaudi::Utils::GetData< TYPE >::return_type	get (IDataProviderSvc *service, const std::string &location, const bool useRootInTES) const

template<class TYPE >
Gaudi::Utils::GetData< TYPE >::return_type	getIfExists (IDataProviderSvc *service, const std::string &location, const bool useRootInTES) const

template<class TYPE , class TYPE2 >
Gaudi::Utils::GetData< TYPE >::return_type	getOrCreate (IDataProviderSvc *service, const std::string &location, const bool useRootInTES) const

Public Member Functions inherited from CommonMessaging< PBASE >
	~CommonMessaging () override=default
	Virtual destructor. More...

	~CommonMessaging () override=default
	Virtual destructor. More...

SmartIF< IMessageSvc > &	msgSvc () const
	The standard message service. More...

SmartIF< IMessageSvc > &	msgSvc () const
	The standard message service. More...

MsgStream &	msgStream () const
	Return an uninitialized MsgStream. More...

MsgStream &	msgStream (const MSG::Level level) const
	Predefined configurable message stream for the efficient printouts. More...

MsgStream &	msgStream () const
	Return an uninitialized MsgStream. More...

MsgStream &	msgStream (const MSG::Level level) const
	Predefined configurable message stream for the efficient printouts. More...

MsgStream &	always () const
	shortcut for the method msgStream(MSG::ALWAYS) More...

MsgStream &	always () const
	shortcut for the method msgStream(MSG::ALWAYS) More...

MsgStream &	fatal () const
	shortcut for the method msgStream(MSG::FATAL) More...

MsgStream &	fatal () const
	shortcut for the method msgStream(MSG::FATAL) More...

MsgStream &	err () const
	shortcut for the method msgStream(MSG::ERROR) More...

MsgStream &	err () const
	shortcut for the method msgStream(MSG::ERROR) More...

MsgStream &	error () const
	shortcut for the method msgStream(MSG::ERROR) More...

MsgStream &	error () const
	shortcut for the method msgStream(MSG::ERROR) More...

MsgStream &	warning () const
	shortcut for the method msgStream(MSG::WARNING) More...

MsgStream &	warning () const
	shortcut for the method msgStream(MSG::WARNING) More...

MsgStream &	info () const
	shortcut for the method msgStream(MSG::INFO) More...

MsgStream &	info () const
	shortcut for the method msgStream(MSG::INFO) More...

MsgStream &	debug () const
	shortcut for the method msgStream(MSG::DEBUG) More...

MsgStream &	debug () const
	shortcut for the method msgStream(MSG::DEBUG) More...

MsgStream &	verbose () const
	shortcut for the method msgStream(MSG::VERBOSE) More...

MsgStream &	verbose () const
	shortcut for the method msgStream(MSG::VERBOSE) More...

MsgStream &	msg () const
	shortcut for the method msgStream(MSG::INFO) More...

MsgStream &	msg () const
	shortcut for the method msgStream(MSG::INFO) More...

MSG::Level	msgLevel () const
	get the output level from the embedded MsgStream More...

bool	msgLevel (MSG::Level lvl) const
	get the output level from the embedded MsgStream More...

MSG::Level	msgLevel () const
	get the output level from the embedded MsgStream More...

bool	msgLevel (MSG::Level lvl) const
	get the output level from the embedded MsgStream More...

Protected Types
typedef std::map< std::string, StatEntity >	Statistics
	the actual type of general counters More...

typedef std::map< std::string, unsigned int >	Counter
	the actual type error/warning counter More...

typedef std::vector< IAlgTool * >	AlgTools
	storage for active tools More...

typedef std::vector< SmartIF< IService > >	Services
	storage for active services More...

typedef std::map< std::string, StatEntity >	Statistics
	the actual type of general counters More...

typedef std::map< std::string, unsigned int >	Counter
	the actual type error/warning counter More...

typedef std::vector< IAlgTool * >	AlgTools
	storage for active tools More...

typedef std::vector< SmartIF< IService > >	Services
	storage for active services More...

Protected Member Functions
	~GaudiCommon () override=default
	Destructor. More...

StatusCode	releaseTool (const IAlgTool *tool) const
	manual forced (and 'safe') release of the tool More...

StatusCode	releaseSvc (const IInterface *svc) const
	manual forced (and 'safe') release of the service More...

	~GaudiCommon () override=default
	Destructor. More...

StatusCode	releaseTool (const IAlgTool *tool) const
	manual forced (and 'safe') release of the tool More...

StatusCode	releaseSvc (const IInterface *svc) const
	manual forced (and 'safe') release of the service More...

Protected Member Functions inherited from CommonMessaging< PBASE >
void	updateMsgStreamOutputLevel (int level)
	Update the output level of the cached MsgStream. More...

void	updateMsgStreamOutputLevel (int level)
	Update the output level of the cached MsgStream. More...

Protected Attributes
SmartIF< ICounterSummarySvc >	m_counterSummarySvc
	a pointer to the CounterSummarySvc More...

std::vector< std::string >	m_counterList = std::vector<std::string>(1,".*")
	list of counters to declare. Set by property CounterList. This can be a regular expression. More...

std::vector< std::string >	m_statEntityList = std::vector<std::string>(0)

Protected Attributes inherited from CommonMessaging< PBASE >
SmartIF< IMessageSvc >	m_msgsvc
	Pointer to the message service;. More...

std::unique_ptr< MsgStream >	m_msgStream
	The predefined message stream. More...

bool	m_streamWithService
	Flag to create a new MsgStream if it was created without the message service. More...

Static Protected Attributes
static const bool	IgnoreRootInTES = false
	Simple definition to be used with the new useRootInTES argument get<TYPE> and put methods. More...

static const bool	UseRootInTES = true
	Simple definition to be used with the new useRootInTES argument get<TYPE> and put methods. More...

Private Member Functions
void	msgLevelHandler (Property &theProp)
	Handle method for changes in the Messaging levels. More...

	GaudiCommon ()=delete

	GaudiCommon (const GaudiCommon &)=delete

GaudiCommon &	operator= (const GaudiCommon &)=delete

void	printErrorHandler (Property &)
	handler for "ErrorPrint" property More...

void	printPropsHandler (Property &)
	handler for "PropertiesPrint" property More...

void	printStatHandler (Property &)
	handler for "StatPrint" property More...

void	addToToolList (IAlgTool *tool) const
	Add the given tool to the list of acquired tools. More...

void	addToServiceList (SmartIF< IService > svc) const
	Add the given service to the list of acquired services. More...

void	initGaudiCommonConstructor (const IInterface *parent=0)
	Constructor initializations. More...

void	msgLevelHandler (Property &theProp)
	Handle method for changes in the Messaging levels. More...

	GaudiCommon ()=delete

	GaudiCommon (const GaudiCommon &)=delete

GaudiCommon &	operator= (const GaudiCommon &)=delete

void	printErrorHandler (Property &)
	handler for "ErrorPrint" property More...

void	printPropsHandler (Property &)
	handler for "PropertiesPrint" property More...

void	printStatHandler (Property &)
	handler for "StatPrint" property More...

void	addToToolList (IAlgTool *tool) const
	Add the given tool to the list of acquired tools. More...

void	addToServiceList (SmartIF< IService > svc) const
	Add the given service to the list of acquired services. More...

void	initGaudiCommonConstructor (const IInterface *parent=0)
	Constructor initializations. More...

Private Attributes
MSG::Level	m_msgLevel = MSG::NIL
	The message level. More...

std::unique_ptr< MsgStream >	m_msgStream
	The predefined message stream. More...

AlgTools	m_tools
	List of active tools. More...

Services	m_services
	List of active services. More...

Counter	m_errors
	Counter of errors. More...

Counter	m_warnings
	counter of warnings More...

Counter	m_infos
	counter of infos More...

Counter	m_exceptions
	Counter of exceptions. More...

Statistics	m_counters
	General counters. More...

IUpdateManagerSvc *	m_updMgrSvc = nullptr
	Pointer to the Update Manager Service instance. More...

bool	m_typePrint = true
	insert the actual C++ type of the algorithm in the messages? More...

bool	m_propsPrint = false
	print properties at initialization? More...

bool	m_statPrint = true
	print counters at finalization ? More...

bool	m_errorsPrint = true
	print warning and error counters at finalization ? More...

std::string	m_context
	The context string. More...

std::string	m_rootInTES
	The rootInTES string. More...

std::string	m_rootOnTES
	The rootOnTES string. More...

double	m_globalTimeOffset = 0
	The globalTimeOffset value. More...

std::string	m_header
	the header row More...

std::string	m_format1
	format for regular statistical printout rows More...

std::string	m_format2
	format for "efficiency" statistical printout rows More...

bool	m_useEffFormat
	flag to use the special "efficiency" format More...

Additional Inherited Members
Public Types inherited from CommonMessaging< PBASE >
using	base_class = CommonMessaging

using	base_class = CommonMessaging

Detailed Description

template<class PBASE>
class GaudiCommon< PBASE >

Implements the common functionality between GaudiTools and GaudiAlgorithms.

Author: Chris Jones Chris.nosp@m.toph.nosp@m.er.Ro.nosp@m.b.Jo.nosp@m.nes@c.nosp@m.ern..nosp@m.ch; Vanya BELYAEV Ivan..nosp@m.Bely.nosp@m.aev@i.nosp@m.tep..nosp@m.ru; Rob Lambert Rob.L.nosp@m.ambe.nosp@m.rt@ce.nosp@m.rn.c.nosp@m.h

Date: 2009-08-04

Definition at line 73 of file GaudiCommon.h.

Member Typedef Documentation

template<class PBASE>

typedef std::vector<IAlgTool*> GaudiCommon< PBASE >::AlgTools

protected

storage for active tools

Definition at line 106 of file GaudiCommon.h.

template<class PBASE>

typedef std::vector<IAlgTool*> GaudiCommon< PBASE >::AlgTools

protected

storage for active tools

Definition at line 106 of file GaudiCommon.h.

template<class PBASE>

typedef std::map<std::string,unsigned int> GaudiCommon< PBASE >::Counter

protected

the actual type error/warning counter

Definition at line 104 of file GaudiCommon.h.

template<class PBASE>

typedef std::map<std::string,unsigned int> GaudiCommon< PBASE >::Counter

protected

the actual type error/warning counter

Definition at line 104 of file GaudiCommon.h.

template<class PBASE>

typedef std::vector<SmartIF<IService> > GaudiCommon< PBASE >::Services

protected

storage for active services

Definition at line 108 of file GaudiCommon.h.

template<class PBASE>

typedef std::vector<SmartIF<IService> > GaudiCommon< PBASE >::Services

protected

storage for active services

Definition at line 108 of file GaudiCommon.h.

template<class PBASE>

typedef std::map<std::string,StatEntity> GaudiCommon< PBASE >::Statistics

protected

the actual type of general counters

Definition at line 102 of file GaudiCommon.h.

template<class PBASE>

typedef std::map<std::string,StatEntity> GaudiCommon< PBASE >::Statistics

protected

the actual type of general counters

Definition at line 102 of file GaudiCommon.h.

Constructor & Destructor Documentation

template<class PBASE>

GaudiCommon< PBASE >::GaudiCommon	(	const std::string &	name,
		ISvcLocator *	pSvcLocator
	)

Algorithm constructor.

template<class PBASE>

GaudiCommon< PBASE >::GaudiCommon	(	const std::string &	type,
		const std::string &	name,
		const IInterface *	parent
	)

Tool constructor.

template<class PBASE>

GaudiCommon< PBASE >::~GaudiCommon ( )

overrideprotecteddefault

Destructor.

template<class PBASE>

GaudiCommon< PBASE >::GaudiCommon ( )

privatedelete

template<class PBASE>

GaudiCommon< PBASE >::GaudiCommon ( const GaudiCommon< PBASE > & )

privatedelete

template<class PBASE>

GaudiCommon< PBASE >::GaudiCommon	(	const std::string &	name,
		ISvcLocator *	pSvcLocator
	)

Algorithm constructor.

template<class PBASE>

GaudiCommon< PBASE >::GaudiCommon	(	const std::string &	type,
		const std::string &	name,
		const IInterface *	parent
	)

Tool constructor.

template<class PBASE>

GaudiCommon< PBASE >::~GaudiCommon ( )

overrideprotecteddefault

Destructor.

template<class PBASE>

GaudiCommon< PBASE >::GaudiCommon ( )

privatedelete

template<class PBASE>

GaudiCommon< PBASE >::GaudiCommon ( const GaudiCommon< PBASE > & )

privatedelete

Member Function Documentation

template<class PBASE >

void GaudiCommon< PBASE >::addToServiceList ( SmartIF< IService > svc ) const

private

Add the given service to the list of acquired services.

Definition at line 437 of file GaudiCommon.icpp.

 {
   if (svc) {
     auto i = std::lower_bound( std::begin(m_services), std::end(m_services), svc, GaudiCommon_details::svc_lt );
     if ( i == std::end(m_services) || !GaudiCommon_details::svc_eq(*i,svc) ) {
             m_services.insert( i, std::move(svc) );
     }  else {
            this->warning() << "Service " << svc->name() << " already present -- skipping" << endmsg;
     }
   }
 }

template<class PBASE>

void GaudiCommon< PBASE >::addToServiceList ( SmartIF< IService > svc ) const

private

Add the given service to the list of acquired services.

template<class PBASE >

void GaudiCommon< PBASE >::addToToolList ( IAlgTool * tool ) const

private

Add the given tool to the list of acquired tools.

Definition at line 419 of file GaudiCommon.icpp.

 {
   if( tool ) {
     if ( this->msgLevel ( MSG::DEBUG ) ) {
       this->debug() << "The tool of type '"
                     << System::typeinfoName(typeid(*tool))
                     << "' has been added with the name '"
                     << tool->name() << "'" << endmsg ;
     }
     m_tools.push_back( tool ) ;
   }
 }

template<class PBASE>

void GaudiCommon< PBASE >::addToToolList ( IAlgTool * tool ) const

private

Add the given tool to the list of acquired tools.

template<class PBASE>

void GaudiCommon< PBASE >::Assert	(	const bool	ok,
		const std::string &	message = `""`,
		const StatusCode	sc = `StatusCode(StatusCode::FAILURE, true)`
	)		const

inline

Assertion - throw exception if the given condition is not fulfilled.

See also: GaudiException

Exceptions

Exception for invalid condition

Parameters

ok	Condition which should be "true"
message	Message to be associated with the exception

template<class PBASE >

void GaudiCommon< PBASE >::Assert	(	const bool	ok,
		const std::string &	message = `""`,
		const StatusCode	sc = `StatusCode(StatusCode::FAILURE, true)`
	)		const

inline

Assertion - throw exception if the given condition is not fulfilled.

See also: GaudiException

Exceptions

Exception for invalid condition

Parameters

ok	Condition which should be "true"
message	Message to be associated with the exception

Definition at line 221 of file GaudiCommonImp.h.

 {
   if (!ok) Exception( msg , sc );
 }

template<class PBASE>

void GaudiCommon< PBASE >::Assert	(	const bool	ok,
		const char *	message,
		const StatusCode	sc = `StatusCode(StatusCode::FAILURE, true)`
	)		const

inline

Assertion - throw exception if the given condition is not fulfilled.

See also: GaudiException

Exceptions

Exception for invalid condition

Parameters

ok	Condition which should be "true"
message	Message to be associated with the exception

template<class PBASE >

void GaudiCommon< PBASE >::Assert	(	const bool	ok,
		const char *	message,
		const StatusCode	sc = `StatusCode(StatusCode::FAILURE, true)`
	)		const

inline

Assertion - throw exception if the given condition is not fulfilled.

See also: GaudiException

Exceptions

Exception for invalid condition

Parameters

ok	Condition which should be "true"
message	Message to be associated with the exception

Definition at line 239 of file GaudiCommonImp.h.

 {
   if (!ok) Exception( msg , sc );
 }

template<class PBASE>

const std::string& GaudiCommon< PBASE >::context ( ) const

inline

Returns the "context" string. Used to identify different processing states.

Definition at line 721 of file GaudiCommon.h.

721 { return m_context; }

GaudiCommon::m_context

std::string m_context

The context string.

Definition: GaudiCommon.h:780

template<class PBASE>

const std::string& GaudiCommon< PBASE >::context ( ) const

inline

Returns the "context" string. Used to identify different processing states.

Definition at line 721 of file GaudiCommon.h.

721 { return m_context; }

GaudiCommon::m_context

std::string m_context

The context string.

Definition: GaudiCommon.h:780

template<class PBASE>

StatEntity& GaudiCommon< PBASE >::counter ( const std::string & tag ) const

inline

accessor to certain counter by name

if ( OK ) { ++counter("OK") ; }
// additive counter ('Flag')
counter("#Tracks") += tracks->size() ;
// multiplicative counter  ('Weight')
counter("ProbTot") *= probability ;

See also: StatEntuty

Parameters

tag	counter name

Returns: the counter itself

Definition at line 511 of file GaudiCommon.h.

511 { return m_counters[tag] ; }

GaudiCommon::m_counters

Statistics m_counters

General counters.

Definition: GaudiCommon.h:765

template<class PBASE>

StatEntity& GaudiCommon< PBASE >::counter ( const std::string & tag ) const

inline

accessor to certain counter by name

if ( OK ) { ++counter("OK") ; }
// additive counter ('Flag')
counter("#Tracks") += tracks->size() ;
// multiplicative counter  ('Weight')
counter("ProbTot") *= probability ;

See also: StatEntuty

Parameters

tag	counter name

Returns: the counter itself

Definition at line 511 of file GaudiCommon.h.

511 { return m_counters[tag] ; }

GaudiCommon::m_counters

Statistics m_counters

General counters.

Definition: GaudiCommon.h:765

template<class PBASE>

const Statistics& GaudiCommon< PBASE >::counters ( void ) const

inline

accessor to all counters

Definition at line 492 of file GaudiCommon.h.

492 { return m_counters ; }

GaudiCommon::m_counters

Statistics m_counters

General counters.

Definition: GaudiCommon.h:765

template<class PBASE>

const Statistics& GaudiCommon< PBASE >::counters ( ) const

inline

accessor to all counters

Definition at line 492 of file GaudiCommon.h.

492 { return m_counters ; }

GaudiCommon::m_counters

Statistics m_counters

General counters.

Definition: GaudiCommon.h:765

template<class PBASE >

StatusCode GaudiCommon< PBASE >::Error	(	const std::string &	msg,
		const StatusCode	st = `StatusCode::FAILURE`,
		const size_t	mx = `10`
	)		const

Print the error message and return with the given StatusCode.

Also performs statistical analysis of the error messages and suppression after the defined number of error instances.

if( a < 0 ) { return Error("a is negative!") ;}
if( b < 0 ) { return Error("b is illegal!" , StatusCode(25) );
if( c < 0 )
   { return Error("c is negative" , StatusCode(35) , 50 );

See also: MsgStream; IMessageSvc; StatusCode

Parameters

msg	Error message
st	StatusCode to return
mx	Maximum number of printouts for this message

Returns: StatusCode

Definition at line 458 of file GaudiCommon.icpp.

 {
   // increase local counter of errors
   const size_t num = ++m_errors[msg] ;
   // If suppressed, just return
   if      ( num  > mx ) { return st ; }
   else if ( UNLIKELY(num == mx) ) // issue one-time suppression message
   { return Print ( "The   ERROR message is suppressed : '" +
                    msg + "'" , st , MSG::ERROR ) ; }
   // return message
   return Print ( msg , st , MSG::ERROR ) ;
 }

template<class PBASE>

StatusCode GaudiCommon< PBASE >::Error	(	const std::string &	msg,
		const StatusCode	st = `StatusCode::FAILURE`,
		const size_t	mx = `10`
	)		const

Print the error message and return with the given StatusCode.

Also performs statistical analysis of the error messages and suppression after the defined number of error instances.

if( a < 0 ) { return Error("a is negative!") ;}
if( b < 0 ) { return Error("b is illegal!" , StatusCode(25) );
if( c < 0 )
   { return Error("c is negative" , StatusCode(35) , 50 );

See also: MsgStream; IMessageSvc; StatusCode

Parameters

msg	Error message
st	StatusCode to return
mx	Maximum number of printouts for this message

Returns: StatusCode

template<class PBASE>

bool GaudiCommon< PBASE >::errorsPrint ( ) const

inline

Print error counters at finalization ?

Definition at line 522 of file GaudiCommon.h.

522 { return m_errorsPrint ; }

GaudiCommon::m_errorsPrint

bool m_errorsPrint

print warning and error counters at finalization ?

Definition: GaudiCommon.h:777

template<class PBASE>

bool GaudiCommon< PBASE >::errorsPrint ( ) const

inline

Print error counters at finalization ?

Definition at line 522 of file GaudiCommon.h.

522 { return m_errorsPrint ; }

GaudiCommon::m_errorsPrint

bool m_errorsPrint

print warning and error counters at finalization ?

Definition: GaudiCommon.h:777

template<class PBASE >

void GaudiCommon< PBASE >::Exception	(	const std::string &	msg,
		const GaudiException &	exc,
		const StatusCode	sc = `StatusCode(StatusCode::FAILURE, true)`
	)		const

Create and (re)-throw a given GaudiException.

See also: GaudiException

Exceptions

GaudiException always thrown!

Parameters

msg	Exception message
exc	(previous) exception of type GaudiException

Definition at line 553 of file GaudiCommon.icpp.

 {
   // increase local counter of exceptions
   ++m_exceptions[ msg ];
   Print ( "Exception (re)throw: " + msg , sc , MSG::FATAL ).ignore();
   throw GaudiException( this->name() + ":: " + msg , this->name() , sc, exc);
 }

template<class PBASE>

void GaudiCommon< PBASE >::Exception	(	const std::string &	msg,
		const GaudiException &	exc,
		const StatusCode	sc = `StatusCode(StatusCode::FAILURE, true)`
	)		const

Create and (re)-throw a given GaudiException.

See also: GaudiException

Exceptions

GaudiException always thrown!

Parameters

msg	Exception message
exc	(previous) exception of type GaudiException

template<class PBASE>

void GaudiCommon< PBASE >::Exception	(	const std::string &	msg,
		const std::exception &	exc,
		const StatusCode	sc = `StatusCode(StatusCode::FAILURE, true)`
	)		const

Create and (re)-throw a given exception.

See also: GaudiException

Exceptions

std::exception always thrown!

Parameters

msg	Exception message
exc	(previous) exception of type std::exception
sc	StatusCode

template<class PBASE >

void GaudiCommon< PBASE >::Exception	(	const std::string &	msg,
		const std::exception &	exc,
		const StatusCode	sc = `StatusCode(StatusCode::FAILURE, true)`
	)		const

Create and (re)-throw a given exception.

See also: GaudiException

Exceptions

std::exception always thrown!

Parameters

msg	Exception message
exc	(previous) exception of type std::exception
sc	StatusCode

Definition at line 568 of file GaudiCommon.icpp.

 {
   // increase local counter of exceptions
   ++m_exceptions[ msg ];
   Print ( "Exception (re)throw: " + msg , sc , MSG::FATAL  ).ignore();
   throw GaudiException( this->name() + ":: " + msg+"("+exc.what()+")", "", sc );
 }

template<class PBASE>

void GaudiCommon< PBASE >::Exception	(	const std::string &	msg = `"no message"`,
		const StatusCode	sc = `StatusCode(StatusCode::FAILURE, true)`
	)		const

Create and throw an exception with the given message.

See also: GaudiException

Exceptions

GaudiException always thrown!

Parameters

msg	Exception message
sc	StatusCode

template<class PBASE >

void GaudiCommon< PBASE >::Exception	(	const std::string &	msg = `"no message"`,
		const StatusCode	sc = `StatusCode(StatusCode::FAILURE, true)`
	)		const

Create and throw an exception with the given message.

See also: GaudiException

Exceptions

GaudiException always thrown!

Parameters

msg	Exception message
sc	StatusCode

Definition at line 583 of file GaudiCommon.icpp.

 {
   // increase local counter of exceptions
   ++m_exceptions[ msg ];
   Print ( "Exception throw: " + msg , sc , MSG::FATAL ).ignore();
   throw GaudiException( this->name() + ":: " + msg , "",  sc );
 }

template<class PBASE >

template<class TYPE >

bool GaudiCommon< PBASE >::exist	(	IDataProviderSvc *	svc,
		const std::string &	location,
		const bool	useRootInTES = `true`
	)		const

inline

Check the existence of a data object or container in the Gaudi Transient Event Store.

bool a1 = exist<DataObject>( evtSvc() , "/Event/MyObject" ) ;

bool a2 = exist<MyHits> ( evtSvc() , "/Event/MyHits" ) ;

Attention: The method respects the setting of the job option RootInTES by prepending the value of this to the data location that is passed. The default setting for RootInTES is "" so has no effect. This behavior can be suppressed by passing the argument useRootInTES = false

Parameters

svc	Pointer to data provider service
location	Address in Gaudi Transient Store
useRootInTES	Flag to turn on(TRUE) off(FALSE) the use of the RootInTES location property

Returns: Boolean indicating status of the request

Return values

true	Data object or container exists and implements a proper interface
true	Failed to locate the data object or container

Definition at line 91 of file GaudiCommonImp.h.

 {
   // check the environment
   Assert( service , "exist():: IDataProvider* points to NULL!"      ) ;
   // check the data object
   Gaudi::Utils::CheckData<TYPE> checker ;
   return checker ( service,
                    fullTESLocation ( location , useRootInTES ) ) ;
 }

template<class PBASE>

template<class TYPE >

bool GaudiCommon< PBASE >::exist	(	IDataProviderSvc *	svc,
		const std::string &	location,
		const bool	useRootInTES = `true`
	)		const

Check the existence of a data object or container in the Gaudi Transient Event Store.

bool a1 = exist<DataObject>( evtSvc() , "/Event/MyObject" ) ;

bool a2 = exist<MyHits> ( evtSvc() , "/Event/MyHits" ) ;

Attention: The method respects the setting of the job option RootInTES by prepending the value of this to the data location that is passed. The default setting for RootInTES is "" so has no effect. This behavior can be suppressed by passing the argument useRootInTES = false

Parameters

svc	Pointer to data provider service
location	Address in Gaudi Transient Store
useRootInTES	Flag to turn on(TRUE) off(FALSE) the use of the RootInTES location property

Returns: Boolean indicating status of the request

Return values

true	Data object or container exists and implements a proper interface
true	Failed to locate the data object or container

template<class PBASE >

StatusCode GaudiCommon< PBASE >::finalize ( )

override

standard finalization method

Returns: status code

Definition at line 258 of file GaudiCommon.icpp.

 {
   StatusCode sc = StatusCode::SUCCESS;
 
   // print the general information about statistical counters
   if ( this->msgLevel(MSG::DEBUG) || (statPrint() && !counters().empty()) )
   {
     // print general statistical counters
     printStat ( statPrint() ? MSG::ALWAYS : MSG::DEBUG ) ;
   }
   //add all counters to the CounterSummarySvc
   if(m_counterSummarySvc && this->svcLoc()->existsService("CounterSummarySvc"))
   {
     if ( this->msgLevel(MSG::DEBUG) ) this->debug() << "adding counters to CounterSummarySvc" << endmsg;
 
     Gaudi::Utils::RegEx::matchList statList{ m_statEntityList };
     Gaudi::Utils::RegEx::matchList counterList{ m_counterList };
 
     for( const auto& i : this->counters() )
     {
       if (statList.Or(i.first) )
         m_counterSummarySvc->addCounter(this->name(),i.first,i.second,
                                         Gaudi::CounterSummary::SaveStatEntity);
       else if (counterList.Or(i.first))
         m_counterSummarySvc->addCounter(this->name(),i.first,i.second);
     }
   }
   // release all located tools and services
   if ( this->msgLevel(MSG::DEBUG) )
   {
     this->debug() << "Tools to release :";
     for ( const auto& i : m_tools )
     {
       this->debug() << " " << i->name();
     }
     this->debug() << endmsg;
   }
   while ( !m_tools.empty() ) { sc = releaseTool( m_tools.back() ) && sc; }
 
   // release all located services
   if ( this->msgLevel(MSG::DEBUG) )
   {
     this->debug() << "Services to release :";
     for ( const auto& i : m_services )
     {
       this->debug() << " " << i->name();
     }
     this->debug() << endmsg;
   }
   while ( !m_services.empty() ) { sc = releaseSvc( m_services.front() ) && sc; }
 
   //release the CounterSummarySvc manually
   m_counterSummarySvc.reset();
 
   // format printout
   if ( !m_errors.empty() || !m_warnings.empty() || !m_exceptions.empty() )
   {
     this->always() << "Exceptions/Errors/Warnings/Infos Statistics : "
              << m_exceptions .size () << "/"
              << m_errors     .size () << "/"
              << m_warnings   .size () << "/"
              << m_infos      .size () << endmsg ;
     if ( errorsPrint() ) { printErrors () ; }
   }
 
   // delete the MsgStream
   resetMsgStream();
 
   // clear *ALL* counters explicitly
   m_counters   .clear() ;
   m_exceptions .clear() ;
   m_infos      .clear() ;
   m_warnings   .clear() ;
   m_errors     .clear() ;
   m_counterList.clear() ;
   m_statEntityList.clear() ;
 
   // finalize base class
   return sc && PBASE::finalize();
 }

template<class PBASE>

StatusCode GaudiCommon< PBASE >::finalize ( )

override

standard finalization method

Returns: status code

template<class PBASE>

const std::string GaudiCommon< PBASE >::fullTESLocation	(	const std::string &	location,
		const bool	useRootInTES
	)		const

Returns the full correct event location given the rootInTes settings.

template<class PBASE >

const std::string GaudiCommon< PBASE >::fullTESLocation	(	const std::string &	location,
		const bool	useRootInTES
	)		const

inline

Returns the full correct event location given the rootInTes settings.

Definition at line 25 of file GaudiCommonImp.h.

 {
   // The logic is:
   // if no R.I.T., give back location
   // if R.I.T., this is the mapping:
   // (note that R.I.T. contains a trailing '/')
   //  location       -> result
   //  -------------------------------------------------
   //  ""             -> R.I.T.[:-1]      ("rit")
   //  "/Event"       -> R.I.T.[:-1]      ("rit")
   //  "/Event/MyObj" -> R.I.T. + "MyObj" ("rit/MyObj")
   //  "MyObj"        -> R.I.T. + "MyObj" ("rit/MyObj")
   return ( !useRootInTES || rootInTES().empty() ?
            location
          :
            location.empty() || ( location == "/Event" ) ?
              rootInTES().substr(0,rootInTES().size()-1)
            :
              0 == location.find("/Event/") ?
                rootInTES() + location.substr(7)
              :
                rootInTES() + location );
 }

template<class PBASE>

template<class TYPE >

Gaudi::Utils::GetData<TYPE>::return_type GaudiCommon< PBASE >::get	(	IDataProviderSvc *	service,
		const std::string &	location,
		const bool	useRootInTES
	)		const

inline

Definition at line 55 of file GaudiCommonImp.h.

 {
   // check the environment
   Assert( service ,    "get():: IDataProvider* points to NULL!"      ) ;
   // get the helper object:
   Gaudi::Utils::GetData<TYPE> getter ;
   return getter ( *this    ,
                   service  ,
                   fullTESLocation ( location , useRootInTES ) ) ;
 }

template<class PBASE>

template<class TYPE >

Gaudi::Utils::GetData<TYPE>::return_type GaudiCommon< PBASE >::get	(	IDataProviderSvc *	service,
		const std::string &	location,
		const bool	useRootInTES
	)		const

inline

Definition at line 55 of file GaudiCommonImp.h.

 {
   // check the environment
   Assert( service ,    "get():: IDataProvider* points to NULL!"      ) ;
   // get the helper object:
   Gaudi::Utils::GetData<TYPE> getter ;
   return getter ( *this    ,
                   service  ,
                   fullTESLocation ( location , useRootInTES ) ) ;
 }

template<class PBASE>

template<class TYPE >

Gaudi::Utils::GetData<TYPE>::return_type GaudiCommon< PBASE >::get	(	IDataProviderSvc *	svc,
		const std::string &	location,
		const bool	useRootInTES = `true`
	)		const

Templated access to the data in Gaudi Transient Store.

Quick and safe access to the data in Gaudi transient store. The method located the data at given address and perform the debug printout about located data

// Will access MCHits from the given location

MCHits* hits = get<MCHits>( evtSvc () , "MC/Hits" );

Attention: The method respects the setting of the job option RootInTES by prepending the value of this to the data location that is passed. The default setting for RootInTES is "" so has no effect. This behavior can be suppressed by passing the argument useRootInTES = false

See also: IDataProviderSvc; SmartDataPtr

Exceptions

GaudiException	for Invalid Data Provider Service
GaudiException	for invalid/unavailable data

Parameters

svc	Pointer to data service (data provider)
location	data location/address in Gaudi Transient Store
useRootInTES	Flag to turn on(TRUE) off(FALSE) the use of the RootInTES location property

Returns: pointer to the data object

template<class PBASE>

template<class TYPE >

Gaudi::Utils::GetData<TYPE>::return_type GaudiCommon< PBASE >::get	(	IDataProviderSvc *	svc,
		const std::string &	location,
		const bool	useRootInTES = `true`
	)		const

Templated access to the data in Gaudi Transient Store.

Quick and safe access to the data in Gaudi transient store. The method located the data at given address and perform the debug printout about located data

// Will access MCHits from the given location

MCHits* hits = get<MCHits>( evtSvc () , "MC/Hits" );

Attention: The method respects the setting of the job option RootInTES by prepending the value of this to the data location that is passed. The default setting for RootInTES is "" so has no effect. This behavior can be suppressed by passing the argument useRootInTES = false

See also: IDataProviderSvc; SmartDataPtr

Exceptions

GaudiException	for Invalid Data Provider Service
GaudiException	for invalid/unavailable data

Parameters

svc	Pointer to data service (data provider)
location	data location/address in Gaudi Transient Store
useRootInTES	Flag to turn on(TRUE) off(FALSE) the use of the RootInTES location property

Returns: pointer to the data object

template<class PBASE>

template<class TYPE >

Gaudi::Utils::GetData<TYPE>::return_type GaudiCommon< PBASE >::getIfExists	(	IDataProviderSvc *	service,
		const std::string &	location,
		const bool	useRootInTES
	)		const

inline

Definition at line 73 of file GaudiCommonImp.h.

 {
   // check the environment
   Assert( service ,    "get():: IDataProvider* points to NULL!"      ) ;
   // get the helper object:
   Gaudi::Utils::GetData<TYPE> getter ;
   return getter ( *this    ,
                   service  ,
                   fullTESLocation ( location , useRootInTES ),
                   false) ;
 }

template<class PBASE>

template<class TYPE >

Gaudi::Utils::GetData<TYPE>::return_type GaudiCommon< PBASE >::getIfExists	(	IDataProviderSvc *	service,
		const std::string &	location,
		const bool	useRootInTES
	)		const

inline

Definition at line 73 of file GaudiCommonImp.h.

 {
   // check the environment
   Assert( service ,    "get():: IDataProvider* points to NULL!"      ) ;
   // get the helper object:
   Gaudi::Utils::GetData<TYPE> getter ;
   return getter ( *this    ,
                   service  ,
                   fullTESLocation ( location , useRootInTES ),
                   false) ;
 }

template<class PBASE>

template<class TYPE >

Gaudi::Utils::GetData<TYPE>::return_type GaudiCommon< PBASE >::getIfExists	(	IDataProviderSvc *	svc,
		const std::string &	location,
		const bool	useRootInTES = `true`
	)		const

Quicker version of the get function which bypasses the check on the retrieved data.

template<class PBASE>

template<class TYPE >

Gaudi::Utils::GetData<TYPE>::return_type GaudiCommon< PBASE >::getIfExists	(	IDataProviderSvc *	svc,
		const std::string &	location,
		const bool	useRootInTES = `true`
	)		const

Quicker version of the get function which bypasses the check on the retrieved data.

template<class PBASE>

template<class TYPE , class TYPE2 >

Gaudi::Utils::GetData<TYPE>::return_type GaudiCommon< PBASE >::getOrCreate	(	IDataProviderSvc *	service,
		const std::string &	location,
		const bool	useRootInTES
	)		const

inline

Definition at line 110 of file GaudiCommonImp.h.

 {
   // check the environment
   Assert ( service , "getOrCreate():: svc points to NULL!" ) ;
   // get the helper object
   Gaudi::Utils::GetOrCreateData<TYPE,TYPE2> getter ;
   return getter ( *this                                     ,
                   service                                   ,
                   fullTESLocation( location, useRootInTES ) ,
                   location                                  ) ;
 }

template<class PBASE>

template<class TYPE , class TYPE2 >

Gaudi::Utils::GetData<TYPE>::return_type GaudiCommon< PBASE >::getOrCreate	(	IDataProviderSvc *	service,
		const std::string &	location,
		const bool	useRootInTES
	)		const

inline

Definition at line 110 of file GaudiCommonImp.h.

 {
   // check the environment
   Assert ( service , "getOrCreate():: svc points to NULL!" ) ;
   // get the helper object
   Gaudi::Utils::GetOrCreateData<TYPE,TYPE2> getter ;
   return getter ( *this                                     ,
                   service                                   ,
                   fullTESLocation( location, useRootInTES ) ,
                   location                                  ) ;
 }

template<class PBASE>

template<class TYPE , class TYPE2 >

Gaudi::Utils::GetData<TYPE>::return_type GaudiCommon< PBASE >::getOrCreate	(	IDataProviderSvc *	svc,
		const std::string &	location,
		const bool	useRootInTES = `true`
	)		const

Get the existing data object from Gaudi Event Transient store.

Alternatively, create new object and register it in TES and return if object does not exist.

MyHits* hits = getOrCreate<MyHits,MyHits>( evtSvc() , "/Event/MyHits" ) ;

Attention: The method respects the setting of the job option RootInTES by prepending the value of this to the data location that is passed. The default setting for RootInTES is "" so has no effect. This behavior can be suppressed by passing the argument useRootInTES = false

Exceptions

GaudiException	for Invalid Data Provider Service
GaudiException	for invalid/unavailable data

Parameters

svc	Pointer to data provider service
location	Location in Gaudi Transient Event Store
useRootInTES	Flag to turn on(TRUE) off(FALSE) the use of the RootInTES location property

Returns: A valid pointer to the data object

template<class PBASE>

template<class TYPE , class TYPE2 >

Gaudi::Utils::GetData<TYPE>::return_type GaudiCommon< PBASE >::getOrCreate	(	IDataProviderSvc *	svc,
		const std::string &	location,
		const bool	useRootInTES = `true`
	)		const

Get the existing data object from Gaudi Event Transient store.

Alternatively, create new object and register it in TES and return if object does not exist.

MyHits* hits = getOrCreate<MyHits,MyHits>( evtSvc() , "/Event/MyHits" ) ;

Attention: The method respects the setting of the job option RootInTES by prepending the value of this to the data location that is passed. The default setting for RootInTES is "" so has no effect. This behavior can be suppressed by passing the argument useRootInTES = false

Exceptions

GaudiException	for Invalid Data Provider Service
GaudiException	for invalid/unavailable data

Parameters

svc	Pointer to data provider service
location	Location in Gaudi Transient Event Store
useRootInTES	Flag to turn on(TRUE) off(FALSE) the use of the RootInTES location property

Returns: A valid pointer to the data object

template<class PBASE>

double GaudiCommon< PBASE >::globalTimeOffset ( ) const

inline

Returns the "globalTimeOffset" double.

Definition at line 727 of file GaudiCommon.h.

727 { return m_globalTimeOffset; }

GaudiCommon::m_globalTimeOffset

double m_globalTimeOffset

The globalTimeOffset value.

Definition: GaudiCommon.h:788

template<class PBASE>

double GaudiCommon< PBASE >::globalTimeOffset ( ) const

inline

Returns the "globalTimeOffset" double.

Definition at line 727 of file GaudiCommon.h.

727 { return m_globalTimeOffset; }

GaudiCommon::m_globalTimeOffset

double m_globalTimeOffset

The globalTimeOffset value.

Definition: GaudiCommon.h:788

template<class PBASE>

StatusCode GaudiCommon< PBASE >::Info	(	const std::string &	msg,
		const StatusCode	st = `StatusCode::SUCCESS`,
		const size_t	mx = `10`
	)		const

Print the info message and return with the given StatusCode.

Also performs statistical analysis of the info messages and suppression after the defined number of instances.

See also: MsgStream; IMessageSvc; StatusCode; GaudiCommon::Warning

Parameters

msg	Info message
st	StatusCode to return
mx	Maximum number of printouts for this message

Returns: The given StatusCode

template<class PBASE >

StatusCode GaudiCommon< PBASE >::Info	(	const std::string &	msg,
		const StatusCode	st = `StatusCode::SUCCESS`,
		const size_t	mx = `10`
	)		const

Print the info message and return with the given StatusCode.

Also performs statistical analysis of the info messages and suppression after the defined number of instances.

See also: MsgStream; IMessageSvc; StatusCode; GaudiCommon::Warning

Parameters

msg	Info message
st	StatusCode to return
mx	Maximum number of printouts for this message

Returns: The given StatusCode

Definition at line 500 of file GaudiCommon.icpp.

 {
   // increase local counter of warnings
   const size_t num = ++m_infos[msg] ;
   // If suppressed, just return
   if      ( num  > mx ) { return st ; }
   else if ( UNLIKELY(num == mx) ) // issue one-time suppression message
   { return Print ( "The INFO message is suppressed : '" +
                    msg + "'" , st , MSG::INFO ) ; }
   // return message
   return Print ( msg , st , MSG::INFO ) ;
 }

template<class PBASE>

void GaudiCommon< PBASE >::initGaudiCommonConstructor ( const IInterface * parent = 0 )

private

Constructor initializations.

template<class PBASE >

void GaudiCommon< PBASE >::initGaudiCommonConstructor ( const IInterface * parent = 0 )

private

Constructor initializations.

< flag to use the special "efficiency" format

Definition at line 63 of file GaudiCommon.icpp.

 {
   // initialise data members
 
   // the header row for counters printout
   m_header  = " |    Counter                                      |     #     |    sum     | mean/eff^* | rms/err^*  |     min     |     max     |" ;
   // format for regular statistical printout rows
   m_format1 = " | %|-48.48s|%|50t||%|10d| |%|11.7g| |%|#11.5g| |%|#11.5g| |%|#12.5g| |%|#12.5g| |" ;
   // format for "efficiency" statistical printout rows
   m_format2 = " |*%|-48.48s|%|50t||%|10d| |%|11.5g| |(%|#9.6g| +- %|-#9.6g|)%%|   -------   |   -------   |" ;
   // flag to use the special "efficiency" format
   m_useEffFormat = true ; 
 
   // job options
   // print error counters at finalization ?
   this->declareProperty
     ( "ErrorsPrint"     , m_errorsPrint     ,
       "Print the statistics of errors/warnings/exceptions")
     -> declareUpdateHandler
     ( &GaudiCommon<PBASE>::printErrorHandler, this  ) ;
   // print properties at initialization?
   this->declareProperty
     ( "PropertiesPrint" , m_propsPrint  ,
       "Print the properties of the component ")
     -> declareUpdateHandler
     ( &GaudiCommon<PBASE>::printPropsHandler, this  ) ;
   // print statistical counters at finalization ?
   this->declareProperty
     ( "StatPrint"       , m_statPrint   ,
       "Print the table of counters"  )
     -> declareUpdateHandler
     ( &GaudiCommon<PBASE>::printStatHandler, this  ) ;
   // insert  the actual C++ type of the algorithm or tool in the messages?
   this->declareProperty
     ( "TypePrint"       , m_typePrint   ,
       "Add the actal C++ component type into the messages" ) ;
   // context
   this->declareProperty ( "Context"         , m_context     ) ;
   // root in TES
   this->declareProperty ( "RootInTES"       , m_rootInTES   ) ;
   // root on TES ( temporary )
   this->declareProperty ( "RootOnTES"       , m_rootOnTES   ) ;
   // global time offset
   this->declareProperty ( "GlobalTimeOffset", m_globalTimeOffset ) ;
 
 
   // the header row for counters printout
   this->declareProperty
     ( "StatTableHeader"        , m_header                          ,
       "The header row for the output Stat-table"                   ) ;
   // format for regular statistical printout rows
   this->declareProperty
     ( "RegularRowFormat"       , m_format1                         ,
       "The format for the regular row in the output Stat-table"    ) ;
   // format for "efficiency" statistical printout rows
   this->declareProperty
     ( "EfficiencyRowFormat"    , m_format2                         ,
       "The format for the regular row in the output Stat-table"    ) ;
   // flag to use the special "efficiency" format
   this->declareProperty
     ( "UseEfficiencyRowFormat" , m_useEffFormat                    ,
       "Use the special format for printout of efficiency counters" ) ;
 
 
   //declare the list of simple counters to write.
   this->declareProperty(
     "CounterList",
     m_counterList=std::vector<std::string>(1,".*"),
     "RegEx list, of simple integer counters for CounterSummary.");
   //declare the list of stat entities to write.
   this->declareProperty(
     "StatEntityList",
     m_statEntityList=std::vector<std::string>(0),
     "RegEx list, of StatEntity counters for CounterSummary.");
 
   // add handler for message level changes
   this->outputLevelProperty().declareUpdateHandler( &GaudiCommon<PBASE>::msgLevelHandler, this );
 
   // setup context from parent if available
   if ( parent )
   {
     if      ( const GaudiAlgorithm* gAlg = dynamic_cast<const GaudiAlgorithm*>(parent) )
     {
       m_context = gAlg->context();
       m_rootInTES = gAlg->rootInTES();
       m_globalTimeOffset = gAlg->globalTimeOffset();
     }
     else if ( const GaudiTool*     gTool = dynamic_cast<const GaudiTool*>     (parent) )
     {
       m_context = gTool->context();
       m_rootInTES = gTool->rootInTES();
       m_globalTimeOffset = gTool->globalTimeOffset();
     }
   }
 
   // Get the job option service
   auto jos = this->template service<IJobOptionsSvc>("JobOptionsSvc");
   if (!jos) Exception("Cannot get JobOptionsSvc");
 
   // Get the "Context" option if in the file...
   const auto myList = jos->getProperties( this->name() );
   if ( myList )
   {
     // Iterate over the list to set the options
     for ( const auto& iter : *myList )
     {
       const StringProperty* sp = dynamic_cast<const StringProperty*>(iter);
       if ( sp )
       {
         if ( iter->name() == "Context" ) {
           m_context = sp->value();
         } else if (  iter->name() == "RootInTES" ) {
           m_rootInTES = sp->value();
         } else if ( iter->name() == "GlobalTimeOffset" ) {
           m_globalTimeOffset = std::stod( sp->value() );
         }
       }
     }
   }
 
 }

template<class PBASE >

StatusCode GaudiCommon< PBASE >::initialize ( )

override

standard initialization method

Returns: status code

Definition at line 196 of file GaudiCommon.icpp.

 {
 
   // initialize base class
   const StatusCode sc = PBASE::initialize();
   if ( sc.isFailure() )
   { return Error ( "Failed to initialise base class PBASE", sc ) ; }
 
 
   // some debug printout
   if ( this->msgLevel(MSG::DEBUG) )
   {
     this->debug() << "Initialize base class GaudiCommon<" << System::typeinfoName(typeid(PBASE)) << ">" << endmsg;
     if ( !context().empty() )
       this->debug() << "Created with context = '" << context() << "'" << endmsg;
   }
 
   // some temporary checks to see if people are using RootOnTES and warn if so
   // TO BE REMOVED ASAP ...
   if ( m_rootInTES.empty() && !m_rootOnTES.empty() )
   {
     m_rootInTES = m_rootOnTES;
     Warning( "RootOnTES option is OBSOLETE -> Use RootInTES instead. RootInTES has been updated to "
              + m_rootInTES, StatusCode::SUCCESS ).ignore();
   }
   else if ( !m_rootInTES.empty() && !m_rootOnTES.empty() )
   {
     Warning( "Options RootOnTES AND RootInTES are defined ! Use RootInTES. RootOnTES is ignored",
              StatusCode::SUCCESS ).ignore();
   }
 
   // Check rootInTES ends with a /
   if ( !m_rootInTES.empty() &&
        m_rootInTES.substr(m_rootInTES.size()-1) != "/" ) m_rootInTES += "/";
 
   //Set up the CounterSummarySvc May need to be changed
   m_counterSummarySvc = this->svcLoc()->service("CounterSummarySvc",false);
   if (this->msgLevel(MSG::DEBUG))
   {
     if (!m_counterSummarySvc)
     this->debug() <<  "could not locate CounterSummarySvc, no counter summary will be made" << endmsg;
     else this->debug() <<  "found CounterSummarySvc OK" << endmsg;
   }
 
   // properties will be printed if asked for or in "MSG::DEBUG" mode
   if      ( propsPrint()         ) { printProps(MSG::ALWAYS); }
   else if ( this->msgLevel(MSG::DEBUG) ) { printProps(MSG::DEBUG);  }
 
   return sc;
 }

template<class PBASE>

StatusCode GaudiCommon< PBASE >::initialize ( )

override

standard initialization method

Returns: status code

template<class PBASE>

void GaudiCommon< PBASE >::msgLevelHandler ( Property & theProp )

private

Handle method for changes in the Messaging levels.

Called whenever the property "OutputLevel" changes to perform all necessary actions locally.

Parameters

theProp Reference to the Property that has changed

template<class PBASE >

void GaudiCommon< PBASE >::msgLevelHandler ( Property & theProp )

private

Handle method for changes in the Messaging levels.

Called whenever the property "OutputLevel" changes to perform all necessary actions locally.

Parameters

theProp Reference to the Property that has changed

Definition at line 681 of file GaudiCommon.icpp.

 {
   // Force a new MsgStream object, to pick up the new settings
   resetMsgStream();
 
   // adjust internal message level
   m_msgLevel =
     this->outputLevel() <  (int) MSG::NIL        ?  MSG::NIL    :
     this->outputLevel() >= (int) MSG::NUM_LEVELS ?  MSG::ALWAYS :
     MSG::Level( this->outputLevel() ) ;
 
   // Keep MessageSvc up to date if needed
   if ( this->msgSvc()->outputLevel(this->name()) != this->outputLevel() )
   {
     this->msgSvc()->setOutputLevel( this->name(), this->outputLevel() );
   }
 
   // printout message
   if ( this->msgLevel(MSG::DEBUG) )
   {
     this->debug() << "Property update for "
             << theProp.name() << " : new value = " << this->outputLevel() << endmsg;
   }
 }

template<class PBASE>

GaudiCommon& GaudiCommon< PBASE >::operator= ( const GaudiCommon< PBASE > & )

privatedelete

template<class PBASE>

GaudiCommon& GaudiCommon< PBASE >::operator= ( const GaudiCommon< PBASE > & )

privatedelete

template<class PBASE>

StatusCode GaudiCommon< PBASE >::Print	(	const std::string &	msg,
		const StatusCode	st = `StatusCode::SUCCESS`,
		const MSG::Level	lev = `MSG::INFO`
	)		const

Print the message and return with the given StatusCode.

See also: MsgStream; IMessageSvc; StatusCode

Parameters

msg	Message to print
st	StatusCode to return
lev	Printout level for the given message

Returns: The given StatusCode

template<class PBASE >

StatusCode GaudiCommon< PBASE >::Print	(	const std::string &	msg,
		const StatusCode	st = `StatusCode::SUCCESS`,
		const MSG::Level	lev = `MSG::INFO`
	)		const

Print the message and return with the given StatusCode.

See also: MsgStream; IMessageSvc; StatusCode

Parameters

msg	Message to print
st	StatusCode to return
lev	Printout level for the given message

Returns: The given StatusCode

Definition at line 520 of file GaudiCommon.icpp.

 {
   // perform printout ?
   if ( !this->msgLevel( lvl ) ) { return st ; }   // RETURN
 
   // use the predefined stream
   MsgStream& str = this->msgStream( lvl ) ;
   if ( typePrint() ) { str << System::typeinfoName(typeid(*this)) << ":: " ; }
 
   // print the message
   str  << msg ;
 
   // test status code
   if      ( st.isSuccess() ) { }
   else if ( StatusCode::FAILURE != st.getCode() )
   { str << " StatusCode=" << st.getCode() ; }
   else
   { str << " StatusCode=FAILURE" ; }
 
   // perform print operation
   str << endmsg ;
 
   // return
   return  st;
 }

template<class PBASE >

void GaudiCommon< PBASE >::printErrorHandler ( Property & )

private

handler for "ErrorPrint" property

Definition at line 748 of file GaudiCommon.icpp.

 {
   // no action if not yet initialized
   if ( this -> FSMState() < Gaudi::StateMachine::INITIALIZED ) { return ; }
   if ( this -> errorsPrint() ) { this -> printErrors () ; }
 }

template<class PBASE>

void GaudiCommon< PBASE >::printErrorHandler ( Property & )

private

handler for "ErrorPrint" property

template<class PBASE>

long GaudiCommon< PBASE >::printErrors ( const MSG::Level level = MSG::ALWAYS ) const

perform the actual printout of error counters

Parameters

level The message level to print at

Returns: number of error counters

template<class PBASE >

long GaudiCommon< PBASE >::printErrors ( const MSG::Level level = MSG::ALWAYS ) const

perform the actual printout of error counters

Parameters

level The message level to print at

Returns: number of error counters

Definition at line 627 of file GaudiCommon.icpp.

 {
   // format for printout
   boost::format ftm ( " #%|-10s| = %|.8s| %|23t| Message = '%s'" );
 
   auto print = [&](const Counter& c, const std::string& label) {
       for (const auto& i : c ) {
         this->msgStream(level) 
           << ( ftm % label % i.second % i.first       )
           << endmsg;
       }
   };
 
   print( m_exceptions, "EXCEPTIONS" );
   print( m_errors,     "ERRORS"     );
   print( m_warnings,   "WARNINGS"   );
   print( m_infos,      "INFOS"      );
 
   // return total number of errors+warnings+exceptions
   return
     m_exceptions .size () +
     m_errors     .size () +
     m_warnings   .size () +
     m_infos      .size () ;
 }

template<class PBASE>

long GaudiCommon< PBASE >::printProps ( const MSG::Level level = MSG::ALWAYS ) const

perform the actual printout of properties

Parameters

level The message level to print at

Returns: number of properties

template<class PBASE >

long GaudiCommon< PBASE >::printProps ( const MSG::Level level = MSG::ALWAYS ) const

perform the actual printout of properties

perform the printout of properties

Parameters

level The message level to print at

Returns: number of properties; number of error counters

Definition at line 660 of file GaudiCommon.icpp.

 {
 
   // print ALL properties
   MsgStream& msg = this->msgStream ( level );
   const auto& properties = this->getProperties() ;
   msg << "List of ALL properties of "
       << System::typeinfoName( typeid( *this ) ) << "/" << this->name()
       << "  #properties = " << properties.size() << endmsg ;
   for ( const auto& property : reverse(properties) )
   {
     msg << "Property ['Name': Value] = " <<  *property << endmsg ;
   }
   return properties.size() ;
 }

template<class PBASE >

void GaudiCommon< PBASE >::printPropsHandler ( Property & )

private

handler for "PropertiesPrint" property

Definition at line 758 of file GaudiCommon.icpp.

 {
   // no action if not yet initialized
   if ( this -> FSMState() < Gaudi::StateMachine::INITIALIZED ) { return ; }
   if ( this -> propsPrint() ) { this -> printProps ( MSG::ALWAYS ) ; }
 }

template<class PBASE>

void GaudiCommon< PBASE >::printPropsHandler ( Property & )

private

handler for "PropertiesPrint" property

template<class PBASE >

long GaudiCommon< PBASE >::printStat ( const MSG::Level level = MSG::ALWAYS ) const

perform the actual printout of statistical counters

Parameters

level The message level to print at

Returns: number of active statistical counters

Definition at line 597 of file GaudiCommon.icpp.

 {
   // print statistics
   if ( counters().empty() ) { return 0 ; }
   MsgStream& msg = this->msgStream ( level ) ;
   //
   msg << "Number of counters : "  << counters().size() ;
   //
   if ( !counters().empty() ) { msg << std::endl << m_header ; }
   //
   for ( const auto& entry : counters() ) 
   {
     msg << std::endl
         << Gaudi::Utils::formatAsTableRow
       ( entry.first  ,
         entry.second ,
         m_useEffFormat  ,
         m_format1       , m_format2 );
   }
   //
   msg << endmsg ;
   //
   return counters().size() ;
 }

template<class PBASE>

long GaudiCommon< PBASE >::printStat ( const MSG::Level level = MSG::ALWAYS ) const

perform the actual printout of statistical counters

Parameters

level The message level to print at

Returns: number of active statistical counters

template<class PBASE >

void GaudiCommon< PBASE >::printStatHandler ( Property & )

private

handler for "StatPrint" property

Definition at line 768 of file GaudiCommon.icpp.

 {
   // no action if not yet initialized
   if ( this -> FSMState() < Gaudi::StateMachine::INITIALIZED ) { return ; }
   if ( this -> statPrint() ) { this -> printStat ( MSG::ALWAYS ) ; }
 }

template<class PBASE>

void GaudiCommon< PBASE >::printStatHandler ( Property & )

private

handler for "StatPrint" property

template<class PBASE>

bool GaudiCommon< PBASE >::propsPrint ( ) const

inline

Print properties at initialization ?

Definition at line 518 of file GaudiCommon.h.

518 { return m_propsPrint ; }

GaudiCommon::m_propsPrint

bool m_propsPrint

print properties at initialization?

Definition: GaudiCommon.h:773

template<class PBASE>

bool GaudiCommon< PBASE >::propsPrint ( ) const

inline

Print properties at initialization ?

Definition at line 518 of file GaudiCommon.h.

518 { return m_propsPrint ; }

GaudiCommon::m_propsPrint

bool m_propsPrint

print properties at initialization?

Definition: GaudiCommon.h:773

template<class PBASE >

DataObject * GaudiCommon< PBASE >::put	(	IDataProviderSvc *	svc,
		DataObject *	object,
		const std::string &	location,
		const bool	useRootInTES = `true`
	)		const

Register a data object or container into Gaudi Event Transient Store.

See also: IDataProviderSvc

Attention: The method respects the setting of the job option RootInTES by prepending the value of this to the data location that is passed. The default setting for RootInTES is "" so has no effect. This behavior can be suppressed by passing the argument useRootInTES = false

Parameters

svc	Pointer to data provider service
object	Data object or container to be registered
location	Location in Gaudi Event Transient Store ("/Event" could be omitted )
useRootInTES	Flag to turn on(TRUE) off(FALSE) the use of the RootInTES location property

Exceptions

GaudiException	for invalid event data service
GaudiException	for invalid object
GaudiException	for error result from event data service

Returns: StatusCode

Return values

StatusCode::SUCCESS	Data was successfully placed in the TES.
StatusCode::FAILURE	Failed to store data in the TES.

Definition at line 715 of file GaudiCommon.icpp.

 {
   // check arguments
   Assert (      svc              , "put():: Invalid 'service'!"       ) ;
   Assert (      object           , "put():: Invalid 'Object'!"        ) ;
   Assert ( !location.empty()     , "put():: Invalid 'address' = '' "  ) ;
   // final data location
   const std::string & fullLocation = fullTESLocation( location, useRootInTES );
   // register the object!
   const StatusCode status = '/' == fullLocation[0] ?
     svc -> registerObject(             fullLocation , object ) :
     svc -> registerObject( "/Event/" + fullLocation , object ) ;
   // check the result!
   if ( status.isFailure() )
   { Exception ( "put():: could not register '"            +
                 System::typeinfoName( typeid( *object ) ) +
                 "' at address '" + fullLocation + "'"  , status ) ; }
   if ( this->msgLevel( MSG::DEBUG ) )
   { Print( "The object of type '"                    +
            System::typeinfoName( typeid( *object ) ) +
            "' is registered in TS at address '"
            + fullLocation + "'" , status , MSG::DEBUG ).ignore() ; }
   return object;
 }

template<class PBASE>

DataObject* GaudiCommon< PBASE >::put	(	IDataProviderSvc *	svc,
		DataObject *	object,
		const std::string &	location,
		const bool	useRootInTES = `true`
	)		const

Register a data object or container into Gaudi Event Transient Store.

See also: IDataProviderSvc

Attention: The method respects the setting of the job option RootInTES by prepending the value of this to the data location that is passed. The default setting for RootInTES is "" so has no effect. This behavior can be suppressed by passing the argument useRootInTES = false

Parameters

svc	Pointer to data provider service
object	Data object or container to be registered
location	Location in Gaudi Event Transient Store ("/Event" could be omitted )
useRootInTES	Flag to turn on(TRUE) off(FALSE) the use of the RootInTES location property

Exceptions

GaudiException	for invalid event data service
GaudiException	for invalid object
GaudiException	for error result from event data service

Returns: StatusCode

Return values

StatusCode::SUCCESS	Data was successfully placed in the TES.
StatusCode::FAILURE	Failed to store data in the TES.

template<class PBASE>

template<class CallerClass >

void GaudiCommon< PBASE >::registerCondition	(	const std::string &	condition,
		StatusCode(CallerClass::*)()	mf = `nullptr`
	)

inline

register the current instance to the UpdateManagerSvc as a consumer for a condition.

Parameters

condition the path inside the Transient Detector Store to the condition object.

mf

optional pointer to the member function to call when the condition object is updated. If the pointer is omitted the user must explicitly provide the class name to the method.

StatusCode MyAlg::initialize(){
   // ...
   registerCondition("/dd/Conditions/Readout/MyDet/MyCond",&MyAlg::i_CallBack);
   registerCondition<MyAlg>("/dd/Conditions/Readout/MyDet/MyOtherCond");
   // ...
   return StatusCode.SUCCESS;
}

Definition at line 565 of file GaudiCommon.h.

                                                                                                      {
     updMgrSvc()->registerCondition(dynamic_cast<CallerClass*>(this),condition,mf);
   }

template<class PBASE>

template<class CallerClass >

void GaudiCommon< PBASE >::registerCondition	(	const std::string &	condition,
		StatusCode(CallerClass::*)()	mf = `nullptr`
	)

inline

register the current instance to the UpdateManagerSvc as a consumer for a condition.

Parameters

condition the path inside the Transient Detector Store to the condition object.

mf

optional pointer to the member function to call when the condition object is updated. If the pointer is omitted the user must explicitly provide the class name to the method.

StatusCode MyAlg::initialize(){
   // ...
   registerCondition("/dd/Conditions/Readout/MyDet/MyCond",&MyAlg::i_CallBack);
   registerCondition<MyAlg>("/dd/Conditions/Readout/MyDet/MyOtherCond");
   // ...
   return StatusCode.SUCCESS;
}

Definition at line 565 of file GaudiCommon.h.

                                                                                                      {
     updMgrSvc()->registerCondition(dynamic_cast<CallerClass*>(this),condition,mf);
   }

template<class PBASE>

template<class CallerClass , class CondType >

void GaudiCommon< PBASE >::registerCondition	(	const std::string &	condition,
		CondType *&	condPtrDest,
		StatusCode(CallerClass::*)()	mf = `NULL`
	)

inline

register the current instance to the UpdateManagerSvc as a consumer for a condition.

This version of the method allow the user to specify where to put a copy of the pointer to the condition object.

Parameters

condition	the path inside the Transient Detector Store to the condition object.
condPtrDest	pointer to fill with the location of the condition object. Note: the pointer can be safely used only in the execute method or in the member function triggered by the update.
mf	optional pointer to the member function to call when the condition object is updated. If the pointer is omitted the user must explicitly provide the class name to the method. class MyAlg: public GaudiAlgorithm { // ... public: virtual StatusCode i_CallBack(); private: Condition m_MyCond; SpecialCondition m_MyOtherCond; // ... }; StatusCode MyAlg::initialize(){ // ... registerCondition("/dd/Conditions/Readout/MyDet/MyCond",m_MyCond,&MyAlg::i_CallBack); registerCondition<MyAlg>("/dd/Conditions/Readout/MyDet/MyOtherCond",m_MyOtherCond); // ... return StatusCode.SUCCESS; }

Definition at line 599 of file GaudiCommon.h.

                                                                       {
     updMgrSvc()->registerCondition(dynamic_cast<CallerClass*>(this),condition,mf,condPtrDest);
   }

template<class PBASE>

template<class CallerClass , class CondType >

void GaudiCommon< PBASE >::registerCondition	(	const std::string &	condition,
		CondType *&	condPtrDest,
		StatusCode(CallerClass::*)()	mf = `NULL`
	)

inline

register the current instance to the UpdateManagerSvc as a consumer for a condition.

This version of the method allow the user to specify where to put a copy of the pointer to the condition object.

Parameters

condition	the path inside the Transient Detector Store to the condition object.
condPtrDest	pointer to fill with the location of the condition object. Note: the pointer can be safely used only in the execute method or in the member function triggered by the update.
mf	optional pointer to the member function to call when the condition object is updated. If the pointer is omitted the user must explicitly provide the class name to the method. class MyAlg: public GaudiAlgorithm { // ... public: virtual StatusCode i_CallBack(); private: Condition m_MyCond; SpecialCondition m_MyOtherCond; // ... }; StatusCode MyAlg::initialize(){ // ... registerCondition("/dd/Conditions/Readout/MyDet/MyCond",m_MyCond,&MyAlg::i_CallBack); registerCondition<MyAlg>("/dd/Conditions/Readout/MyDet/MyOtherCond",m_MyOtherCond); // ... return StatusCode.SUCCESS; }

Definition at line 599 of file GaudiCommon.h.

                                                                       {
     updMgrSvc()->registerCondition(dynamic_cast<CallerClass*>(this),condition,mf,condPtrDest);
   }

template<class PBASE>

template<class CallerClass >

void GaudiCommon< PBASE >::registerCondition	(	char *	condition,
		StatusCode(CallerClass::*)()	mf = `NULL`
	)

inline

just to avoid conflicts with the version using a pointer to a template class.

Definition at line 605 of file GaudiCommon.h.

                                                                                        {
     updMgrSvc()->registerCondition(dynamic_cast<CallerClass*>(this),std::string(condition),mf);
   }

template<class PBASE>

template<class CallerClass >

void GaudiCommon< PBASE >::registerCondition	(	char *	condition,
		StatusCode(CallerClass::*)()	mf = `NULL`
	)

inline

just to avoid conflicts with the version using a pointer to a template class.

Definition at line 605 of file GaudiCommon.h.

                                                                                        {
     updMgrSvc()->registerCondition(dynamic_cast<CallerClass*>(this),std::string(condition),mf);
   }

template<class PBASE>

template<class CallerClass , class TargetClass >

void GaudiCommon< PBASE >::registerCondition	(	TargetClass *	condition,
		StatusCode(CallerClass::*)()	mf = `NULL`
	)

inline

register the current instance to the UpdateManagerSvc as a consumer for a condition.

Parameters

condition the path inside the Transient Detector Store to the condition object.

mf

optional pointer to the member function to call when the condition object is updated. If the pointer is omitted the user must explicitly provide the class name to the method.

StatusCode MyAlg::initialize(){
   // ...
   registerCondition("/dd/Conditions/Readout/MyDet/MyCond",&MyAlg::i_CallBack);
   registerCondition<MyAlg>("/dd/Conditions/Readout/MyDet/MyOtherCond");
   // ...
   return StatusCode.SUCCESS;
}

Definition at line 624 of file GaudiCommon.h.

                                                                                               {
     updMgrSvc()->registerCondition(dynamic_cast<CallerClass*>(this),condition,mf);
   }

template<class PBASE>

template<class CallerClass , class TargetClass >

void GaudiCommon< PBASE >::registerCondition	(	TargetClass *	condition,
		StatusCode(CallerClass::*)()	mf = `NULL`
	)

inline

register the current instance to the UpdateManagerSvc as a consumer for a condition.

Parameters

condition the path inside the Transient Detector Store to the condition object.

mf

optional pointer to the member function to call when the condition object is updated. If the pointer is omitted the user must explicitly provide the class name to the method.

StatusCode MyAlg::initialize(){
   // ...
   registerCondition("/dd/Conditions/Readout/MyDet/MyCond",&MyAlg::i_CallBack);
   registerCondition<MyAlg>("/dd/Conditions/Readout/MyDet/MyOtherCond");
   // ...
   return StatusCode.SUCCESS;
}

Definition at line 624 of file GaudiCommon.h.

                                                                                               {
     updMgrSvc()->registerCondition(dynamic_cast<CallerClass*>(this),condition,mf);
   }

template<class PBASE>

StatusCode GaudiCommon< PBASE >::release ( const IInterface * interface ) const

Manual forced (and 'safe') release of the active tool or service.

IMyTool* mytool = tool<IMyTool>( .... ) ;
mytool->spendCPUtime() ;
release ( mytool ) ;
IMySvc* msvc = svc<IMySvc>( .... ) ;
msvc->spendCPUtime() ;
release ( msvc ) ;

Parameters

interface Interface pointer to the interface to be released

Returns: StatusCode

Return values

StatusCode::SUCCESS	Tool or service was successfully released
StatusCode::FAILURE	Error releasing too or service

template<class PBASE >

StatusCode GaudiCommon< PBASE >::release ( const IInterface * interface ) const

Manual forced (and 'safe') release of the active tool or service.

IMyTool* mytool = tool<IMyTool>( .... ) ;
mytool->spendCPUtime() ;
release ( mytool ) ;
IMySvc* msvc = svc<IMySvc>( .... ) ;
msvc->spendCPUtime() ;
release ( msvc ) ;

Parameters

interface Interface pointer to the interface to be released

Returns: StatusCode

Return values

StatusCode::SUCCESS	Tool or service was successfully released
StatusCode::FAILURE	Error releasing too or service

Definition at line 348 of file GaudiCommon.icpp.

 {
   if ( !interface )
   { return Error ( "release(IInterface):: IInterface* points to NULL!" ) ; }
   // dispatch between tools and services
   const IAlgTool* algTool = dynamic_cast<const IAlgTool*>( interface )  ;
   // perform the actual release
   return algTool ? releaseTool( algTool ) : releaseSvc( interface ) ;
 }

template<class PBASE>

StatusCode GaudiCommon< PBASE >::releaseSvc ( const IInterface * svc ) const

protected

manual forced (and 'safe') release of the service

template<class PBASE >

StatusCode GaudiCommon< PBASE >::releaseSvc ( const IInterface * svc ) const

protected

manual forced (and 'safe') release of the service

Definition at line 398 of file GaudiCommon.icpp.

 {
   if( !Svc ) return Error ( "releaseSvc(IInterface):: IInterface* points to NULL!" ) ;
   SmartIF<IService> svc{const_cast<IInterface*>(Svc)};
   if (!svc) return Warning( "releaseSvc(IInterface):: IInterface* is not a service" );
   auto it = std::lower_bound( std::begin(m_services), std::end(m_services), svc, GaudiCommon_details::svc_lt );
   if (it == m_services.end() || !GaudiCommon_details::svc_eq(*it,svc)) {
     return Warning( "releaseSvc(IInterface):: IInterface* is not active" );
   }
   if ( this->msgLevel(MSG::DEBUG) ) {
     this->debug() << "Releasing service '" << (*it)->name() << "'" << endmsg;
   }
   m_services.erase(it);
   return StatusCode::SUCCESS;
 }

template<class PBASE>

StatusCode GaudiCommon< PBASE >::releaseTool ( const IAlgTool * tool ) const

protected

manual forced (and 'safe') release of the tool

template<class PBASE >

StatusCode GaudiCommon< PBASE >::releaseTool ( const IAlgTool * tool ) const

protected

manual forced (and 'safe') release of the tool

Definition at line 363 of file GaudiCommon.icpp.

 {
   if( !algTool   )
   { return Error ( "releaseTool(IAlgTool):: IAlgTool* points to NULL!" ) ; }
   if( !this->toolSvc() )
   { return Error ( "releaseTool(IAlgTool):: IToolSvc* points to NULL!" ) ; }
   // find a tool in the list of active tools
   auto it = std::find( m_tools.rbegin() , m_tools.rend() , algTool ) ;
   if(  m_tools.rend() == it )
   { return Warning("releaseTool(IAlgTool):: IAlgTool* is not active"   ) ; }
   // get the tool
   IAlgTool* t = *it ;
   // cache name
   const std::string name = t->name();
   if ( this->msgLevel(MSG::DEBUG) )
   { this->debug() << "Releasing tool '" << name << "'" << endmsg; }
   // remove the tool from the lists
   m_tools.erase( --it.base() ) ;
   // release tool
   if ( this->msgLevel(MSG::DEBUG) ) {
     this->debug() << "The tool '" << t->name() << "' of type '"
                   << System::typeinfoName(typeid(*t))
                   << "' is released" << endmsg;
   }
   const StatusCode sc = this->toolSvc()->releaseTool( t ) ;
   return  sc.isSuccess() ? 
             sc :
             Warning( "releaseTool(IAlgTool):: error from IToolSvc releasing "+name , sc ) ;
 }

template<class PBASE >

void GaudiCommon< PBASE >::resetMsgStream ( ) const

inline

Definition at line 231 of file GaudiCommonImp.h.

 {
   m_msgStream.reset();
 }

template<class PBASE>

void GaudiCommon< PBASE >::resetMsgStream ( ) const

template<class PBASE>

const std::string& GaudiCommon< PBASE >::rootInTES ( ) const

inline

Returns the "rootInTES" string.

Used as the directory root in the TES for which all data access refers to (both saving and retrieving).

Definition at line 725 of file GaudiCommon.h.

725 { return m_rootInTES; }

GaudiCommon::m_rootInTES

std::string m_rootInTES

The rootInTES string.

Definition: GaudiCommon.h:782

template<class PBASE>

const std::string& GaudiCommon< PBASE >::rootInTES ( ) const

inline

Returns the "rootInTES" string.

Used as the directory root in the TES for which all data access refers to (both saving and retrieving).

Definition at line 725 of file GaudiCommon.h.

725 { return m_rootInTES; }

GaudiCommon::m_rootInTES

std::string m_rootInTES

The rootInTES string.

Definition: GaudiCommon.h:782

template<class PBASE>

StatusCode GaudiCommon< PBASE >::runUpdate ( )

inline

asks the UpdateManagerSvc to perform an update of the instance (if needed) without waiting the next BeginEvent incident.

It is useful if the instance can be instantiated after a BeginEvent incident, and used before the next one (for example with tools).

StatusCode MyTool::initialize(){
  // ...
  return runUpdate();
}

Definition at line 638 of file GaudiCommon.h.

638 { return updMgrSvc()->update(this); }

GaudiCommon::updMgrSvc

IUpdateManagerSvc * updMgrSvc() const

Short-cut to locate the Update Manager Service.

Definition: GaudiCommonImp.h:211

IUpdateManagerSvc::update

StatusCode update(CallerClass *instance)

Update the given instance.

Definition: IUpdateManagerSvc.h:245

template<class PBASE>

StatusCode GaudiCommon< PBASE >::runUpdate ( )

inline

asks the UpdateManagerSvc to perform an update of the instance (if needed) without waiting the next BeginEvent incident.

It is useful if the instance can be instantiated after a BeginEvent incident, and used before the next one (for example with tools).

StatusCode MyTool::initialize(){
  // ...
  return runUpdate();
}

Definition at line 638 of file GaudiCommon.h.

638 { return updMgrSvc()->update(this); }

GaudiCommon::updMgrSvc

IUpdateManagerSvc * updMgrSvc() const

Short-cut to locate the Update Manager Service.

Definition: GaudiCommonImp.h:211

IUpdateManagerSvc::update

StatusCode update(CallerClass *instance)

Update the given instance.

Definition: IUpdateManagerSvc.h:245

template<class PBASE>

const Services& GaudiCommon< PBASE >::services ( ) const

inline

get the list of aquired services

Definition at line 707 of file GaudiCommon.h.

707 { return m_services ; } // get all services

GaudiCommon::m_services

Services m_services

List of active services.

Definition: GaudiCommon.h:754

template<class PBASE>

const Services& GaudiCommon< PBASE >::services ( ) const

inline

get the list of aquired services

Definition at line 707 of file GaudiCommon.h.

707 { return m_services ; } // get all services

GaudiCommon::m_services

Services m_services

List of active services.

Definition: GaudiCommon.h:754

template<class PBASE>

bool GaudiCommon< PBASE >::statPrint ( ) const

inline

Print statistical counters at finalization ?

Definition at line 520 of file GaudiCommon.h.

520 { return m_statPrint ; }

GaudiCommon::m_statPrint

bool m_statPrint

print counters at finalization ?

Definition: GaudiCommon.h:775

template<class PBASE>

bool GaudiCommon< PBASE >::statPrint ( ) const

inline

Print statistical counters at finalization ?

Definition at line 520 of file GaudiCommon.h.

520 { return m_statPrint ; }

GaudiCommon::m_statPrint

bool m_statPrint

print counters at finalization ?

Definition: GaudiCommon.h:775

template<class PBASE>

template<class SERVICE >

SmartIF<SERVICE> GaudiCommon< PBASE >::svc	(	const std::string &	name,
		const bool	create = `true`
	)		const

A useful method for the easy location of services.

IMyService* mySvc = svc<IMyService>( "MyServiceType" );

Attention: The services located with this method will be released automatically

See also: IService; ISevcLocator; Service

Exceptions

GaudiException	for error in Algorithms::service
GaudiException	for invalid service

Parameters

name	service type name
create	Flag for creation of non-existing services

Returns: A pointer to the service

template<class PBASE >

template<class SERVICE >

SmartIF< SERVICE > GaudiCommon< PBASE >::svc	(	const std::string &	name,
		const bool	create = `true`
	)		const

inline

A useful method for the easy location of services.

IMyService* mySvc = svc<IMyService>( "MyServiceType" );

Attention: The services located with this method will be released automatically

See also: IService; ISevcLocator; Service

Exceptions

GaudiException	for error in Algorithms::service
GaudiException	for invalid service

Parameters

name	service type name
create	Flag for creation of non-existing services

Returns: A pointer to the service

Definition at line 178 of file GaudiCommonImp.h.

 {
   Assert ( this->svcLoc(), "ISvcLocator* points to NULL!" );
   SmartIF<SERVICE> s;
   // check if we already have this service
   auto it = std::lower_bound( std::begin(m_services), std::end(m_services), name, GaudiCommon_details::svc_lt );
   if ( it != std::end(m_services) && GaudiCommon_details::svc_eq(*it,name) ) {
     // Try to get the requested interface
     s = *it;
     // check the results
     if ( !s ) {
       Exception ("svc():: Could not retrieve Svc '" + name + "'", StatusCode::FAILURE);
     }
   } else {
     auto baseSvc = this->svcLoc()->service(name, create);
     // Try to get the requested interface
     s = baseSvc;
     // check the results
     if ( !baseSvc || !s ) {
       Exception ("svc():: Could not retrieve Svc '" + name + "'", StatusCode::FAILURE);
     }
     // add the tool into list of known tools, to be properly released
     addToServiceList(baseSvc);
   }
   // return *VALID* located service
   return s;
 }

template<class PBASE >

template<class TOOL >

TOOL * GaudiCommon< PBASE >::tool	(	const std::string &	type,
		const std::string &	name,
		const IInterface *	parent = `0`,
		bool	create = `true`
	)		const

inline

Useful method for the easy location of tools.

IMyTool* myTool =

tool<IMyTool>( "MyToolType", "MyToolName", this );

Attention: The tools located with this method will be released automatically

See also: IToolSvc; IAlgTool

Exceptions

GaudiException	for invalid Tool Service
GaudiException	for error from Tool Service
GaudiException	for invalid tool

Parameters

type	Tool type
name	Tool name
parent	Tool parent
create	Flag for creation of nonexisting tools

Returns: A pointer to the tool

Definition at line 128 of file GaudiCommonImp.h.

 {
   // for empty names delegate to another method
   if ( name.empty() ) return tool<TOOL>( type , parent , create ) ;
   Assert( this->toolSvc(), "tool():: IToolSvc* points to NULL!" ) ;
   // get the tool from Tool Service
   TOOL* Tool = nullptr ;
   const StatusCode sc =
     this->toolSvc()->retrieveTool ( type , name , Tool , parent , create ) ;
   if ( sc.isFailure() )
   { Exception("tool():: Could not retrieve Tool '" + type + "'/'" + name + "'", sc ) ; }
   if ( !Tool )
   { Exception("tool():: Could not retrieve Tool '" + type + "'/'" + name + "'"     ) ; }
   // add the tool into list of known tools to be properly released
   addToToolList( Tool );
   // return *VALID* located tool
   return Tool ;
 }

template<class PBASE>

template<class TOOL >

TOOL* GaudiCommon< PBASE >::tool	(	const std::string &	type,
		const std::string &	name,
		const IInterface *	parent = `0`,
		bool	create = `true`
	)		const

Useful method for the easy location of tools.

IMyTool* myTool =

tool<IMyTool>( "MyToolType", "MyToolName", this );

Attention: The tools located with this method will be released automatically

See also: IToolSvc; IAlgTool

Exceptions

GaudiException	for invalid Tool Service
GaudiException	for error from Tool Service
GaudiException	for invalid tool

Parameters

type	Tool type
name	Tool name
parent	Tool parent
create	Flag for creation of nonexisting tools

Returns: A pointer to the tool

template<class PBASE >

template<class TOOL >

TOOL * GaudiCommon< PBASE >::tool	(	const std::string &	type,
		const IInterface *	parent = `0`,
		bool	create = `true`
	)		const

inline

A useful method for the easy location of tools.

IMyTool* myTool = tool<IMyTool>( "PublicToolType" );

Attention: The tools located with this method will be released automatically

See also: IToolSvc; IAlgTool

Exceptions

GaudiException	for invalid Tool Service
GaudiException	for error from Tool Service
GaudiException	for invalid tool

Parameters

type	Tool type, could be of "Type/Name" format
parent	Tool parent
create	Flag for creation of non-existing tools

Returns: A pointer to the tool

Definition at line 154 of file GaudiCommonImp.h.

 {
   // check the environment
   Assert ( PBASE::toolSvc(), "IToolSvc* points to NULL!" );
   // retrieve the tool from Tool Service
   TOOL* Tool = nullptr ;
   const StatusCode sc =
     this->toolSvc() -> retrieveTool ( type, Tool, parent , create   );
   if ( sc.isFailure() )
   { Exception("tool():: Could not retrieve Tool '" + type + "'", sc ) ; }
   if ( !Tool )
   { Exception("tool():: Could not retrieve Tool '" + type + "'"     ) ; }
   // add the tool into the list of known tools to be properly released
   addToToolList( Tool );
   // return *VALID* located tool
   return Tool ;
 }

template<class PBASE>

template<class TOOL >

TOOL* GaudiCommon< PBASE >::tool	(	const std::string &	type,
		const IInterface *	parent = `0`,
		bool	create = `true`
	)		const

A useful method for the easy location of tools.

IMyTool* myTool = tool<IMyTool>( "PublicToolType" );

Attention: The tools located with this method will be released automatically

See also: IToolSvc; IAlgTool

Exceptions

GaudiException	for invalid Tool Service
GaudiException	for error from Tool Service
GaudiException	for invalid tool

Parameters

type	Tool type, could be of "Type/Name" format
parent	Tool parent
create	Flag for creation of non-existing tools

Returns: A pointer to the tool

template<class PBASE>

const AlgTools& GaudiCommon< PBASE >::tools ( ) const

inline

get the list of aquired tools

Definition at line 705 of file GaudiCommon.h.

705 { return m_tools ; } // get all tools

GaudiCommon::m_tools

AlgTools m_tools

List of active tools.

Definition: GaudiCommon.h:752

template<class PBASE>

const AlgTools& GaudiCommon< PBASE >::tools ( ) const

inline

get the list of aquired tools

Definition at line 705 of file GaudiCommon.h.

705 { return m_tools ; } // get all tools

GaudiCommon::m_tools

AlgTools m_tools

List of active tools.

Definition: GaudiCommon.h:752

template<class PBASE>

bool GaudiCommon< PBASE >::typePrint ( ) const

inline

Insert the actual C++ type of the algorithm/tool in the messages ?

Definition at line 516 of file GaudiCommon.h.

516 { return m_typePrint ; }

GaudiCommon::m_typePrint

bool m_typePrint

insert the actual C++ type of the algorithm in the messages?

Definition: GaudiCommon.h:771

template<class PBASE>

bool GaudiCommon< PBASE >::typePrint ( ) const

inline

Insert the actual C++ type of the algorithm/tool in the messages ?

Definition at line 516 of file GaudiCommon.h.

516 { return m_typePrint ; }

GaudiCommon::m_typePrint

bool m_typePrint

insert the actual C++ type of the algorithm in the messages?

Definition: GaudiCommon.h:771

template<class PBASE >

IUpdateManagerSvc * GaudiCommon< PBASE >::updMgrSvc ( ) const

inline

Short-cut to locate the Update Manager Service.

Definition at line 211 of file GaudiCommonImp.h.

 {
   if ( !m_updMgrSvc )
   { m_updMgrSvc = svc<IUpdateManagerSvc>("UpdateManagerSvc",true); }
   return m_updMgrSvc ;
 }

template<class PBASE>

IUpdateManagerSvc* GaudiCommon< PBASE >::updMgrSvc ( ) const

inline

Short-cut to locate the Update Manager Service.

template<class PBASE >

StatusCode GaudiCommon< PBASE >::Warning	(	const std::string &	msg,
		const StatusCode	st = `StatusCode::FAILURE`,
		const size_t	mx = `10`
	)		const

Print the warning message and return with the given StatusCode.

Also performs statistical analysis of the warning messages and suppression after the defined number of error instances.

if( a < 0 ) { return Warning("a is negative!") ;}
if( b < 0 ) { return Warning("b is illegal!" , StatusCode(25) );
if( c < 0 )
   { return Warning("c is negative" , StatusCode(35) , 50 );

See also: MsgStream; IMessageSvc; StatusCode

Parameters

msg	Warning message
st	StatusCode to return
mx	Maximum number of printouts for this message

Returns: The given StatusCode

Definition at line 479 of file GaudiCommon.icpp.

 {
   // increase local counter of warnings
   const size_t num = ++m_warnings[msg] ;
   // If suppressed, just return
   if      ( num  > mx ) { return st ; }
   else if ( UNLIKELY(num == mx) ) // issue one-time suppression message
   { return Print ( "The WARNING message is suppressed : '" +
                    msg + "'" , st , MSG::WARNING ) ; }
   // return message
   return Print ( msg , st , MSG::WARNING ) ;
 }

template<class PBASE>

StatusCode GaudiCommon< PBASE >::Warning	(	const std::string &	msg,
		const StatusCode	st = `StatusCode::FAILURE`,
		const size_t	mx = `10`
	)		const

Print the warning message and return with the given StatusCode.

Also performs statistical analysis of the warning messages and suppression after the defined number of error instances.

if( a < 0 ) { return Warning("a is negative!") ;}
if( b < 0 ) { return Warning("b is illegal!" , StatusCode(25) );
if( c < 0 )
   { return Warning("c is negative" , StatusCode(35) , 50 );

See also: MsgStream; IMessageSvc; StatusCode

Parameters

msg	Warning message
st	StatusCode to return
mx	Maximum number of printouts for this message

Returns: The given StatusCode

Member Data Documentation

template<class PBASE>

static const bool GaudiCommon< PBASE >::IgnoreRootInTES = false

staticprotected

Simple definition to be used with the new useRootInTES argument get<TYPE> and put methods.

If used with cause the RootInTES option to be IGNORED.

Useful to aid with code readability. e.g.

// Get data, ignoring the setting of rootInTES()

MyData * data = get<MyData>( "/Event/MyData", IgnoreRootInTES );

Definition at line 85 of file GaudiCommon.h.

template<class PBASE>

std::string GaudiCommon< PBASE >::m_context

private

The context string.

Definition at line 780 of file GaudiCommon.h.

template<class PBASE>

std::vector< std::string > GaudiCommon< PBASE >::m_counterList = std::vector<std::string>(1,".*")

protected

list of counters to declare. Set by property CounterList. This can be a regular expression.

Definition at line 115 of file GaudiCommon.h.

template<class PBASE>

Statistics GaudiCommon< PBASE >::m_counters

mutableprivate

General counters.

Definition at line 765 of file GaudiCommon.h.

template<class PBASE>

SmartIF< ICounterSummarySvc > GaudiCommon< PBASE >::m_counterSummarySvc

protected

a pointer to the CounterSummarySvc

Definition at line 113 of file GaudiCommon.h.

template<class PBASE>

Counter GaudiCommon< PBASE >::m_errors

mutableprivate

Counter of errors.

Definition at line 757 of file GaudiCommon.h.

template<class PBASE>

bool GaudiCommon< PBASE >::m_errorsPrint = true

private

print warning and error counters at finalization ?

Definition at line 777 of file GaudiCommon.h.

template<class PBASE>

Counter GaudiCommon< PBASE >::m_exceptions

mutableprivate

Counter of exceptions.

Definition at line 763 of file GaudiCommon.h.

template<class PBASE>

std::string GaudiCommon< PBASE >::m_format1

private

format for regular statistical printout rows

Definition at line 793 of file GaudiCommon.h.

template<class PBASE>

std::string GaudiCommon< PBASE >::m_format2

private

format for "efficiency" statistical printout rows

Definition at line 795 of file GaudiCommon.h.

template<class PBASE>

double GaudiCommon< PBASE >::m_globalTimeOffset = 0

private

The globalTimeOffset value.

Definition at line 788 of file GaudiCommon.h.

template<class PBASE>

std::string GaudiCommon< PBASE >::m_header

private

the header row

Definition at line 791 of file GaudiCommon.h.

template<class PBASE>

Counter GaudiCommon< PBASE >::m_infos

mutableprivate

counter of infos

Definition at line 761 of file GaudiCommon.h.

template<class PBASE>

MSG::Level GaudiCommon< PBASE >::m_msgLevel = MSG::NIL

private

The message level.

Definition at line 747 of file GaudiCommon.h.

template<class PBASE>

std::unique_ptr< MsgStream > GaudiCommon< PBASE >::m_msgStream

mutableprivate

The predefined message stream.

Definition at line 750 of file GaudiCommon.h.

template<class PBASE>

bool GaudiCommon< PBASE >::m_propsPrint = false

private

print properties at initialization?

Definition at line 773 of file GaudiCommon.h.

template<class PBASE>

std::string GaudiCommon< PBASE >::m_rootInTES

private

The rootInTES string.

Definition at line 782 of file GaudiCommon.h.

template<class PBASE>

std::string GaudiCommon< PBASE >::m_rootOnTES

private

The rootOnTES string.

Note, this job option is OBSOLETE, but retained temporarily to allow easy migration. Please update your code to use RootInTES instead. This option will be removed at some point.

Definition at line 786 of file GaudiCommon.h.

template<class PBASE>

Services GaudiCommon< PBASE >::m_services

mutableprivate

List of active services.

Definition at line 754 of file GaudiCommon.h.

template<class PBASE>

std::vector< std::string > GaudiCommon< PBASE >::m_statEntityList = std::vector<std::string>(0)

protected

Definition at line 117 of file GaudiCommon.h.

template<class PBASE>

bool GaudiCommon< PBASE >::m_statPrint = true

private

print counters at finalization ?

Definition at line 775 of file GaudiCommon.h.

template<class PBASE>

AlgTools GaudiCommon< PBASE >::m_tools

mutableprivate

List of active tools.

Definition at line 752 of file GaudiCommon.h.

template<class PBASE>

bool GaudiCommon< PBASE >::m_typePrint = true

private

insert the actual C++ type of the algorithm in the messages?

Definition at line 771 of file GaudiCommon.h.

template<class PBASE>

IUpdateManagerSvc * GaudiCommon< PBASE >::m_updMgrSvc = nullptr

mutableprivate

Pointer to the Update Manager Service instance.

Definition at line 768 of file GaudiCommon.h.

template<class PBASE>

bool GaudiCommon< PBASE >::m_useEffFormat

private

flag to use the special "efficiency" format

Definition at line 797 of file GaudiCommon.h.

template<class PBASE>

Counter GaudiCommon< PBASE >::m_warnings

mutableprivate

counter of warnings

Definition at line 759 of file GaudiCommon.h.

template<class PBASE>

static const bool GaudiCommon< PBASE >::UseRootInTES = true

staticprotected

Simple definition to be used with the new useRootInTES argument get<TYPE> and put methods.

If used with cause the RootInTES option to be USED

Useful to aid with code readability. e.g.

// Get data, using the setting of rootInTES()
MyData * data = get<MyData>( "/Event/MyData", UseRootInTES );
// note the default setting is true, so this is equivalent to
MyData * data = get<MyData>( "/Event/MyData" );

Definition at line 97 of file GaudiCommon.h.

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

InstallArea/x86_64-slc6-gcc48-opt/include/GaudiAlg/GaudiCommon.h
InstallArea/x86_64-slc6-gcc48-opt/include/GaudiAlg/GaudiCommonImp.h
GaudiAlg/src/lib/GaudiCommon.icpp

Public Member Functions

Protected Types

Protected Member Functions

Protected Attributes

Static Protected Attributes

Private Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

template<class PBASE> class GaudiCommon< PBASE >

Member Typedef Documentation

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation

template<class PBASE>
class GaudiCommon< PBASE >