GaudiException Class Reference

Define general base for Gaudi exception. More...

#include <GaudiKernel/GaudiException.h>

Inheritance diagram for GaudiException:

Collaboration diagram for GaudiException:

Public Member Functions
	GaudiException (std::string Message, std::string Tag, StatusCode Code)
	Constructor (1) More...
	GaudiException (std::string Message, std::string Tag, StatusCode Code, const GaudiException &Exception)
	Constructor (2) More...
	GaudiException (std::string Message, std::string Tag, StatusCode Code, const std::exception &Exception)
	Constructor (3) More...
	GaudiException (const GaudiException &Exception)
	Copy constructor (deep copying!) More...
virtual	~GaudiException () throw ()
	destructor (perform the deletion of "previous" field!) More...
GaudiException &	operator= (const GaudiException &Exception)
	assignment operator More...
virtual const std::string &	message () const
	error message to be printed More...
virtual const std::string &	setMessage (const std::string &newMessage)
	update the error message to be printed More...
virtual const std::string &	tag () const
	name tag for the exception, or exception type More...
virtual const std::string &	setTag (const std::string &newTag)
	update name tag More...
virtual const StatusCode &	code () const
	StatusCode for Exception. More...
virtual const StatusCode &	setCode (const StatusCode &newStatus)
	update the status code for the exception More...
virtual GaudiException *	previous () const
	get the previous exception ( "previous" element in the linked list) More...
virtual const std::string &	backTrace () const
	return the stack trace at instantiation More...
virtual std::ostream &	printOut (std::ostream &os=std::cerr) const
	methods for overloaded printout to std::ostream& and MsgStream& More...
virtual MsgStream &	printOut (MsgStream &os) const
	Output the exception to the Gaudi MsgStream. More...
virtual GaudiException *	clone () const
	clone operation More...
const char *	what () const override throw ()
	method from std::exception More...
Public Member Functions inherited from std::exception
T	what (T... args)
T	~exception (T... args)
T	operator= (T... args)
T	exception (T... args)

Protected Attributes
std::string	m_message
std::string	m_tag
	error message More...
StatusCode	m_code
	exception tag More...
std::string	m_backTrace
	status code for exception More...
std::unique_ptr< GaudiException >	m_previous
	stack trace at instantiation More...

Static Protected Attributes
static bool	s_proc
	"previous" element in the linked list More...

Friends
class	StatusCode

Detailed Description

Define general base for Gaudi exception.

Author

Vanya Belyaev

Sebastien Ponce

Definition at line 21 of file GaudiException.h.

Constructor & Destructor Documentation

GaudiException() [1/4]

GaudiException::GaudiException	(	std::string	Message,
		std::string	Tag,
		StatusCode	Code
	)

Constructor (1)

Parameters

Message	error message
Tag	"name tag", or exeption type
Code	status code

Definition at line 16 of file GaudiException.cpp.

    : m_message( std::move( Message ) ), m_tag( std::move( Tag ) ), m_code( std::move( Code ) ) {
  s_proc      = true;
  m_backTrace = captureBacktrace( Code );
}

GaudiException() [2/4]

GaudiException::GaudiException	(	std::string	Message,
		std::string	Tag,
		StatusCode	Code,
		const GaudiException &	Exception
	)

Constructor (2)

Parameters

Message	error message
Tag	"name tag", or exeption type
Code	status code
Exception	"previous" exception

Definition at line 22 of file GaudiException.cpp.

    : m_message( std::move( Message ) )
    , m_tag( std::move( Tag ) )
    , m_code( std::move( Code ) )
    , m_previous( Exception.clone() ) {
  // Do not capture backtrace in outer chained exceptions, so only innermost exception is printed
}

GaudiException() [3/4]

GaudiException::GaudiException	(	std::string	Message,
		std::string	Tag,
		StatusCode	Code,
		const std::exception &	Exception
	)

Constructor (3)

Parameters

Message	error message
Tag	"name tag", or exeption type
Code	status code
Exception	"previous" exception (used to improve the error message)

Definition at line 30 of file GaudiException.cpp.

    : m_message( std::move( Message ) ), m_tag( std::move( Tag ) ), m_code( std::move( Code ) ) {
  s_proc = true;
  m_message += ": " + System::typeinfoName( typeid( Exception ) ) + ", " + Exception.what();
  m_backTrace = captureBacktrace( Code );
}

GaudiException() [4/4]

GaudiException::GaudiException

(

const GaudiException &

Exception

)

Copy constructor (deep copying!)

Definition at line 37 of file GaudiException.cpp.

    : std::exception( Exception )
    , m_message{Exception.message()}
    , m_tag{Exception.tag()}
    , m_code{Exception.code()}
    , m_backTrace{Exception.backTrace()}
    , m_previous{Exception.previous() ? Exception.previous()->clone() : nullptr} {
  s_proc = true;
}

~GaudiException()

GaudiException::~GaudiException ( ) throw ( )

virtual

destructor (perform the deletion of "previous" field!)

Definition at line 47 of file GaudiException.cpp.

                                        {
  m_code.setChecked();
  s_proc = false;
}

Member Function Documentation

backTrace()

virtual const std::string& GaudiException::backTrace ( ) const

inlinevirtual

return the stack trace at instantiation

Definition at line 88 of file GaudiException.h.

{ return m_backTrace; }

clone()

virtual GaudiException* GaudiException::clone ( ) const

inlinevirtual

clone operation

Reimplemented in UpdateManagerException.

Definition at line 97 of file GaudiException.h.

{ return new GaudiException( *this ); }

code()

virtual const StatusCode& GaudiException::code ( ) const

inlinevirtual

StatusCode for Exception.

Definition at line 76 of file GaudiException.h.

{ return m_code; }

message()

virtual const std::string& GaudiException::message ( ) const

inlinevirtual

error message to be printed

Definition at line 58 of file GaudiException.h.

{ return m_message; }

operator=()

GaudiException & GaudiException::operator=

(

const GaudiException &

Exception

)

assignment operator

Definition at line 52 of file GaudiException.cpp.

                                                                           {
  m_message   = Exception.message();
  m_tag       = Exception.tag();
  m_code      = Exception.code();
  m_backTrace = Exception.backTrace();
  m_previous.reset( Exception.previous() ? Exception.previous()->clone() : nullptr );
  return *this;
}

previous()

virtual GaudiException* GaudiException::previous ( ) const

inlinevirtual

get the previous exception ( "previous" element in the linked list)

Definition at line 85 of file GaudiException.h.

{ return m_previous.get(); }

printOut() [1/2]

std::ostream & GaudiException::printOut ( std::ostream &  os = std::cerr ) const

virtual

methods for overloaded printout to std::ostream& and MsgStream&

Definition at line 61 of file GaudiException.cpp.

                                                           {
  os << tag() << " \t " << message() << "\t StatusCode=" << code();
  if ( !backTrace().empty() ) os << std::endl << "Exception stack trace\n" << backTrace();
  return ( 0 != previous() ) ? previous()->printOut( os << std::endl ) : os;
}

printOut() [2/2]

MsgStream & GaudiException::printOut ( MsgStream &  os ) const

virtual

Output the exception to the Gaudi MsgStream.

Definition at line 67 of file GaudiException.cpp.

                                                         {
  os << tag() << " \t " << message() << "\t StatusCode=" << code();
  if ( !backTrace().empty() ) os << endmsg << "Exception stack trace\n" << backTrace();
  return ( 0 != previous() ) ? previous()->printOut( os << endmsg ) : os;
}

setCode()

virtual const StatusCode& GaudiException::setCode ( const StatusCode &  newStatus )

inlinevirtual

update the status code for the exception

Definition at line 79 of file GaudiException.h.

                                                                   {
    m_code = newStatus;
    return code();
  }

setMessage()

virtual const std::string& GaudiException::setMessage ( const std::string &  newMessage )

inlinevirtual

update the error message to be printed

Definition at line 61 of file GaudiException.h.

                                                                     {
    m_message = newMessage;
    return message();
  }

setTag()

virtual const std::string& GaudiException::setTag ( const std::string &  newTag )

inlinevirtual

update name tag

Definition at line 70 of file GaudiException.h.

                                                             {
    m_tag = newTag;
    return tag();
  }

tag()

virtual const std::string& GaudiException::tag ( ) const

inlinevirtual

name tag for the exception, or exception type

Definition at line 67 of file GaudiException.h.

{ return m_tag; }

what()

const char* GaudiException::what ( ) const throw ( )

inlineoverride

method from std::exception

Definition at line 100 of file GaudiException.h.

{ return message().c_str(); }

Friends And Related Function Documentation

StatusCode

friend class StatusCode

friend

Definition at line 22 of file GaudiException.h.

Member Data Documentation

m_backTrace

std::string GaudiException::m_backTrace

protected

status code for exception

Definition at line 106 of file GaudiException.h.

m_code

StatusCode GaudiException::m_code

protected

exception tag

Definition at line 105 of file GaudiException.h.

m_message

std::string GaudiException::m_message

protected

Definition at line 103 of file GaudiException.h.

m_previous

std::unique_ptr<GaudiException> GaudiException::m_previous

protected

stack trace at instantiation

Definition at line 107 of file GaudiException.h.

m_tag

std::string GaudiException::m_tag

protected

error message

Definition at line 104 of file GaudiException.h.

s_proc

bool GaudiException::s_proc

staticprotected

"previous" element in the linked list

Definition at line 108 of file GaudiException.h.

---

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

• GaudiKernel/GaudiKernel/GaudiException.h
• GaudiKernel/src/Lib/GaudiException.cpp