#include <GaudiKernel/Message.h>

Collaboration diagram for Message:

Public Member Functions
	Message ()
	Default constructor. More...

	Message (const char src, int type, const char msg)
	Constructor. More...

	Message (std::string src, int type, std::string msg)
	Constructor. More...

	~Message ()=default
	Default destructor. More...

const std::string &	getMessage () const
	Get the message string. More...

void	setMessage (std::string msg)
	Set the message string. More...

int	getType () const
	Get the message type. More...

void	setType (int msg_type)
	Set the message type. More...

const std::string &	getSource () const
	Get the message source. More...

void	setSource (std::string src)
	Set the message source. More...

const std::string &	getFormat () const
	Get the format string. More...

void	setFormat (std::string msg) const
	Set the format string. More...

const std::string &	getTimeFormat () const
	Get the time format string. More...

void	setTimeFormat (std::string timeFormat) const
	Set the time format string. More...

bool	operator< (const Message &test)
	Needed to build maps. More...

Static Public Member Functions
static const std::string	getDefaultFormat ()
	Get the default format string. More...

static const std::string	getDefaultTimeFormat ()
	Get the default time format string. More...

Private Member Functions
void	invalidFormat () const
	Called when an invalid format string is encountered. More...

void	makeFormattedMsg (const std::string &format) const
	Format the message. More...

void	decodeFormat (const std::string &format) const
	Decode format. More...

void	sizeField (const std::string &text) const
	Truncate or pad the output string to the field width as necessary. More...

void	setWidth (const std::string &formatArg) const
	Set the width of a stream. More...

Private Attributes
std::string	m_message
	The message. More...

std::string	m_source = "UNKNOWN"
	The source. More...

std::string	m_format = DEFAULT_FORMAT
	The format string. More...

std::string	m_time_format = DEFAULT_TIME_FORMAT
	Time format string. More...

int	m_type = 0
	The type. More...

std::string	m_formatted_msg
	Formatted message. More...

char	m_fill = ' '
	The current fill character. More...

int	m_width = 0
	The current field width. More...

bool	m_left = true
	Justification. More...

size_t	m_ecSlot

long int	m_ecEvt

pthread_t	m_ecThrd

Static Private Attributes
static const char	FORMAT_PREFIX = '%'
	Formatting string characters. More...

static const char	JUSTIFY_LEFT = 'L'
	The character used to indicate start of left text justification. More...

static const char	JUSTIFY_RIGHT = 'R'
	The character used to indicate start of right text justification. More...

static const char	MESSAGE = 'M'
	The character used to indicate that the message should be printed. More...

static const char	TYPE = 'T'
	The character used to indicate that the message type should be printed. More...

static const char	TIME = 't'
	The character used to indicate that the message timestamp should be printed. More...

static const char	UTIME = 'u'
	The character used to indicate that the message timestamp should be printed in UTC time. More...

static const char	SOURCE = 'S'
	The character used to indicate that the message source should be printed. More...

static const char	FILL = 'F'
	The character used to indicate that the previous character is to be used for padding out fields if the text is not long enough. More...

static const char	WIDTH = 'W'
	The character used to indicate that the previous decimal characters should be taken as the field width. More...

static constexpr const char *	DEFAULT_FORMAT = "% F%18W%S%7W%R%T %0W%M"
	The default message format. More...

static constexpr const char *	DEFAULT_TIME_FORMAT = "%Y-%m-%d %H:%M:%S,%f"
	The default time format. More...

static const char	SLOT = 's'
	For slot and event number from EventContext. More...

static const char	EVTNUM = 'e'

static const char	THREAD = 'X'

Friends
std::ostream &	operator<< (std::ostream &stream, const Message &msg)
	Insert the message into a stream. More...

bool	operator== (const Message &a, const Message &b)
	Insert the message into a stream. More...

Detailed Description

The Message class.

This class is used to contain messages which can then be formatted and sent to a message service

Author: Iain Last

Definition at line 15 of file Message.h.

Constructor & Destructor Documentation

Message::Message ( )

Default constructor.

Definition at line 30 of file Message.cpp.

 {
   m_ecSlot = Gaudi::Hive::currentContextId();
   m_ecEvt = Gaudi::Hive::currentContextEvt();
   m_ecThrd = pthread_self();
 }

Message::Message	(	const char *	src,
		int	type,
		const char *	msg
	)

Constructor.

Definition at line 43 of file Message.cpp.

                                                               :
   m_message( msg ), m_source( src ), m_type( type )
 {
   m_ecSlot = Gaudi::Hive::currentContextId();
   m_ecEvt = Gaudi::Hive::currentContextEvt();
   m_ecThrd = pthread_self();
 }

Message::Message	(	std::string	src,
		int	type,
		std::string	msg
	)

Constructor.

Definition at line 57 of file Message.cpp.

                                                           :
   m_message( std::move(msg) ), m_source( std::move(src) ), m_type( type )
 {
   m_ecSlot = Gaudi::Hive::currentContextId();
   m_ecEvt = Gaudi::Hive::currentContextEvt();
   m_ecThrd = pthread_self();
 }

Message::~Message ( )

default

Default destructor.

Member Function Documentation

void Message::decodeFormat ( const std::string & format ) const

private

Decode format.

Definition at line 292 of file Message.cpp.

 {
   if ( ! format.empty() ) {
     const char FORMAT_TYPE = format[ format.length() - 1 ];
     const std::string FORMAT_PARAM = format.substr( 0, format.length() - 1 );
 
     // Now test the format.
     std::string level;
     switch( FORMAT_TYPE ) {
     case FILL:
       if ( FORMAT_PARAM.length() == 1 ) {
         m_fill = FORMAT_PARAM[0];
       }
       else
         invalidFormat();
       break;
 
     case TIME:
       {
         sizeField( formattedTime ( m_time_format ) );
       }
       break;
 
     case UTIME:
       {
         sizeField( formattedTime ( m_time_format, true ) );
       }
       break;
 
     case THREAD:
       {
     std::ostringstream ost;
     //  ost << "0x" << std::hex << pthread_self();
     ost << "0x" << std::hex << m_ecThrd;
     const std::string& thrStr( ost.str() );
     sizeField( thrStr );
       }
       break;
 
     case SLOT:
       {
         if (m_ecEvt >= 0) {
           std::ostringstream ost;
           ost << m_ecSlot;
           const std::string& slotStr (ost.str());
           sizeField( slotStr );
         } else {
           const std::string& slotStr( "" );
           sizeField( slotStr );
         }
       }
       break;
 
     case EVTNUM:
       {
         if (m_ecEvt >= 0 ) {
           std::ostringstream ost;
           ost << m_ecEvt;
           const std::string& slotStr (ost.str());
           sizeField( slotStr );
         } else {
           const std::string& slotStr( "" );
           sizeField( slotStr );
         }
       }
       break;
 
     case MESSAGE:
       sizeField( m_message );
       break;
 
     case SOURCE:
       sizeField( m_source );
       break;
 
     case TYPE:
       switch ( m_type )    {
 #define SET(x)  case x:  level=#x;  break
         SET( NIL );
         SET( VERBOSE );
         SET( DEBUG );
         SET( INFO );
         SET( WARNING );
         SET( ERROR );
         SET( FATAL );
         case ALWAYS:       level="SUCCESS"; break;
         default:
               level = "UNKNOWN";
               break;
 #undef SET
       }
       sizeField( level );
       break;
 
     case FORMAT_PREFIX: m_formatted_msg += FORMAT_PREFIX; break;
     case JUSTIFY_RIGHT: m_left = false; break;
     case JUSTIFY_LEFT: m_left = true; break;
     case WIDTH: setWidth( FORMAT_PARAM ); break;
     default: invalidFormat(); break;
     }
   }
   else
     invalidFormat();
 }

const std::string Message::getDefaultFormat ( )

static

Get the default format string.

Definition at line 187 of file Message.cpp.

 {
   return DEFAULT_FORMAT;
 }

const std::string Message::getDefaultTimeFormat ( )

static

Get the default time format string.

Definition at line 226 of file Message.cpp.

 {
   return DEFAULT_TIME_FORMAT ;
 }

const std::string & Message::getFormat ( ) const

Get the format string.

Definition at line 176 of file Message.cpp.

 {
   return m_format;
 }

const std::string & Message::getMessage ( ) const

Get the message string.

Definition at line 71 of file Message.cpp.

 {
   return m_message;
 }

const std::string & Message::getSource ( ) const

Get the message source.

Definition at line 115 of file Message.cpp.

 {
   return m_source;
 }

const std::string & Message::getTimeFormat ( ) const

Get the time format string.

Definition at line 215 of file Message.cpp.

 {
   return m_time_format;
 }

int Message::getType ( ) const

Get the message type.

Definition at line 93 of file Message.cpp.

 {
   return m_type;
 }

void Message::invalidFormat ( ) const

private

Called when an invalid format string is encountered.

Definition at line 404 of file Message.cpp.

 {
   makeFormattedMsg( DEFAULT_FORMAT );
 }

void Message::makeFormattedMsg ( const std::string & format ) const

private

Format the message.

Definition at line 251 of file Message.cpp.

 {
   m_formatted_msg.clear();
   auto i = format.begin();
   while( i != format.end() ) {
 
     // Output format string until format statement found.
     while(  i != format.end() && *i != FORMAT_PREFIX )
       m_formatted_msg += *i++;
 
     // Test for end of format string.
     if ( i == format.end() ) break;
     i++;
 
     // Find type of formatting.
     std::string this_format;
     while( i != format.end() && *i != FORMAT_PREFIX &&
            *i != MESSAGE && *i != TYPE && *i != SOURCE &&
            *i != FILL && *i != WIDTH && *i != TIME && *i != UTIME &&
            *i != SLOT && *i != EVTNUM && *i != THREAD &&
            *i != JUSTIFY_LEFT && *i != JUSTIFY_RIGHT ) {
       this_format += *i++;
     }
 
     // Reached end of string with improper format.
     if ( i == format.end() ) {
       invalidFormat();
       break;
     }
 
     this_format += *i++;
     decodeFormat( this_format );
   }
 }

bool Message::operator< ( const Message & test )

Needed to build maps.

Definition at line 150 of file Message.cpp.

 {
   return m_type   < b.m_type ||
          m_source < b.m_source ||
          m_message < b.m_message;
 }

void Message::setFormat ( std::string msg ) const

Set the format string.

Definition at line 200 of file Message.cpp.

 {
     if (LIKELY(!format.empty())) {
         m_format = std::move(format);
     } else {
         m_format = DEFAULT_FORMAT;
     }
 }

void Message::setMessage ( std::string msg )

Set the message string.

Definition at line 82 of file Message.cpp.

 {
   m_message = std::move(msg);
 }

void Message::setSource ( std::string src )

Set the message source.

Definition at line 126 of file Message.cpp.

 {
   m_source = std::move(src);
 }

void Message::setTimeFormat ( std::string timeFormat ) const

Set the time format string.

Definition at line 239 of file Message.cpp.

 {
   m_time_format = ( timeFormat.empty() ? DEFAULT_TIME_FORMAT
                                        : std::move(timeFormat) );
 }

void Message::setType ( int msg_type )

Set the message type.

Definition at line 104 of file Message.cpp.

 {
   m_type = msg_type;
 }

void Message::setWidth ( const std::string & formatArg ) const

private

Set the width of a stream.

Definition at line 429 of file Message.cpp.

 {
   // Convert string to int, if string contains digits only...
   if ( all_digits(formatArg) ) m_width = std::stoi(formatArg);
   else invalidFormat();
 }

void Message::sizeField ( const std::string & text ) const

private

Truncate or pad the output string to the field width as necessary.

Definition at line 443 of file Message.cpp.

 {
   std::string newText;
   if ( m_width == 0 || m_width == static_cast<int>( text.length() ) ) {
     newText = text;
   }
   else {
 
     // Truncate the text if it is too long.
     if ( m_width < static_cast<int>( text.length() ) ) {
       newText = text.substr( 0, m_width );
       for ( int i = 0, j = newText.length()-1; i < 3 && j >= 0; ++i, --j )
         newText[ j ] = '.';
     }
 
     // Pad the text.
     else {
       newText = std::string( m_width, m_fill );
       if ( m_left )
         newText.replace( newText.begin(), newText.begin() + text.length(),
                          text.begin(), text.end() );
       else
         newText.replace( newText.end() - text.length(), newText.end(),
                          text.begin(), text.end() );
     }
   }
 
   m_formatted_msg += newText;
 }

Friends And Related Function Documentation

std::ostream& operator<<	(	std::ostream &	stream,
		const Message &	msg
	)

friend

Insert the message into a stream.

Definition at line 137 of file Message.cpp.

 {
   msg.makeFormattedMsg( msg.m_format );
   stream << msg.m_formatted_msg;
   return stream;
 }

bool operator==	(	const Message &	a,
		const Message &	b
	)

friend

Insert the message into a stream.

Definition at line 163 of file Message.cpp.

 {
   return a.m_source == b.m_source &&
     a.m_type == b.m_type &&
     a.m_message == b.m_message;
 }

Member Data Documentation

constexpr const char* Message::DEFAULT_FORMAT = "% F%18W%S%7W%R%T %0W%M"

staticprivate

The default message format.

Definition at line 160 of file Message.h.

constexpr const char* Message::DEFAULT_TIME_FORMAT = "%Y-%m-%d %H:%M:%S,%f"

staticprivate

The default time format.

Definition at line 164 of file Message.h.

const char Message::EVTNUM = 'e'

staticprivate

Definition at line 168 of file Message.h.

const char Message::FILL = 'F'

staticprivate

The character used to indicate that the previous character is to be used for padding out fields if the text is not long enough.

Definition at line 148 of file Message.h.

const char Message::FORMAT_PREFIX = '%'

staticprivate

Formatting string characters.

The character used to prefix formatting commands.

Definition at line 121 of file Message.h.

const char Message::JUSTIFY_LEFT = 'L'

staticprivate

The character used to indicate start of left text justification.

Definition at line 124 of file Message.h.

const char Message::JUSTIFY_RIGHT = 'R'

staticprivate

The character used to indicate start of right text justification.

Definition at line 127 of file Message.h.

long int Message::m_ecEvt

private

Definition at line 172 of file Message.h.

size_t Message::m_ecSlot

private

Definition at line 171 of file Message.h.

pthread_t Message::m_ecThrd

private

Definition at line 173 of file Message.h.

char Message::m_fill = ' '

mutableprivate

The current fill character.

Definition at line 110 of file Message.h.

std::string Message::m_format = DEFAULT_FORMAT

mutableprivate

The format string.

Definition at line 98 of file Message.h.

std::string Message::m_formatted_msg

mutableprivate

Formatted message.

Definition at line 107 of file Message.h.

bool Message::m_left = true

mutableprivate

Justification.

Definition at line 116 of file Message.h.

std::string Message::m_message

private

The message.

Definition at line 92 of file Message.h.

std::string Message::m_source = "UNKNOWN"

private

The source.

Definition at line 95 of file Message.h.

std::string Message::m_time_format = DEFAULT_TIME_FORMAT

mutableprivate

Time format string.

Definition at line 101 of file Message.h.

int Message::m_type = 0

private

The type.

Definition at line 104 of file Message.h.

int Message::m_width = 0

mutableprivate

The current field width.

Definition at line 113 of file Message.h.

const char Message::MESSAGE = 'M'

staticprivate

The character used to indicate that the message should be printed.

Definition at line 130 of file Message.h.

const char Message::SLOT = 's'

staticprivate

For slot and event number from EventContext.

Definition at line 167 of file Message.h.

const char Message::SOURCE = 'S'

staticprivate

The character used to indicate that the message source should be printed.

Definition at line 143 of file Message.h.

const char Message::THREAD = 'X'

staticprivate

Definition at line 169 of file Message.h.

const char Message::TIME = 't'

staticprivate

The character used to indicate that the message timestamp should be printed.

Definition at line 136 of file Message.h.

const char Message::TYPE = 'T'

staticprivate

The character used to indicate that the message type should be printed.

Definition at line 133 of file Message.h.

const char Message::UTIME = 'u'

staticprivate

The character used to indicate that the message timestamp should be printed in UTC time.

Definition at line 140 of file Message.h.

const char Message::WIDTH = 'W'

staticprivate

The character used to indicate that the previous decimal characters should be taken as the field width.

Definition at line 153 of file Message.h.

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

GaudiKernel/GaudiKernel/Message.h
GaudiKernel/src/Lib/Message.cpp

Public Member Functions

Static Public Member Functions

Private Member Functions

Private Attributes

Static Private Attributes

Friends

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Friends And Related Function Documentation

Member Data Documentation