trick/include/trick/MessageSubscriber.hh
Alex Lin 8f76605f3b Create Message client that writes to screen on a separate thread #553
Created a new message class that will copy incoming messages to a
buffer area.  The buffer area is pre allocated during simulation
initialization.  On a separate thread the buffer area is written
to std::cout.
2018-01-25 15:59:19 -06:00

73 lines
2.1 KiB
C++

#ifndef MESSAGESUBSCRIBER_HH
#define MESSAGESUBSCRIBER_HH
/*
PURPOSE: ( MessageSubscriber Class )
*/
#include <streambuf>
#include <iostream>
#include <string>
namespace Trick {
/**
* This class defines a message subscriber that can subscribe to a MessagePublisher.
*/
class MessageSubscriber {
public:
MessageSubscriber() ;
/** Toggle to enable/disable this message subscriber.\n */
bool enabled ; /**< trick_units(--) */
/** Toggle to enable/disable adding color to message.\n */
bool color ; /**< trick_units(--) */
/** Name of the subscriber\n */
std::string name ; /**< trick_units(--) */
/**
@brief Enable (default) or disable this message subscriber, so that it outputs the messages it receives.
@param yes_no - true to enable, false to disable
@return always 0
*/
int set_enabled(bool yes_no) ;
/**
@brief Enable/disable adding color to messages.
@param yes_no - true to enable, false to disable
@return always 0
*/
int set_color(bool yes_no) ;
/**
@brief The destructor.
*/
virtual ~MessageSubscriber() {} ;
/**
@brief Initializes the subscriber
*/
virtual int init() { return 0 ; } ;
/**
@brief Get a message and send to output. This gets called every time when the message publisher
that this subscriber subscribes to publishes a message. Actual output done in the derived class.
@param level - received message level
@param header - received message header
@param message - received message text
*/
virtual void update( unsigned int level , std::string header, std::string message ) = 0 ;
/**
@brief Shutdown the subscriber
*/
virtual int shutdown() { return 0 ; } ;
} ;
}
#endif