PreFsmActionListener class. More...

#include <FsmActionListener.h>

Public Member Functions
virtual	~PreFsmActionListener ()
	Destructor .

virtual void	operator() (const char *)=0
	Virtual Callback function.

Static Public Member Functions
static const char *	toString (PreFsmActionListenerType type)
	Convert PreFsmActionListenerType into the string.

Detailed Description

PreFsmActionListener class.

PreFsmActionListener class is a base class for the listener objects which realize callback to hook FSM related pre-actions. To hook execution just before a FSM action, the callback object should be defined as follows, and set to RTObject through appropriate callback set function.

class MyListener
  : public PreFsmActionListener
{
  std::string m_name;
public:
  MyListener(const char* name) : m_name(name) {}
  virtual ~MyListener() {}

  virtual void operator()(const char* state_name)
  {
    std::cout << "Listner name:  " m_name << std::endl;
    std::cout << "Current state: " state_name << std::endl;
  };
};

The listener class defined above is set to RTObject as follows.

RTC::ReturnCode_t ConsoleIn::onInitialize()
{
    addPreFsmActionListener(PreFsmActionListenerType::PRE_ON_STATE_CHANGE,
                            new MyListener("init listener"),
                            true);
   :

The first argument "PRE_ON_STATE_CHANGE" specifies callback hook point, and the following values are available. Not all the callback points are implemented. It depends on the FSM implementations.

PRE_ON_INIT: just before "init" action
PRE_ON_ENTRY: just before "entry" action
PRE_ON_DO: just before "do" action
PRE_ON_EXIT: just before "exit" action
PRE_ON_STATE_CHANGE: just before state transition action

The second argument is a pointers to the listener object. The third argument is a flag for automatic object destruction. When "true" is given to the third argument, the given object in second argument is automatically destructed with RTObject. In the "false " case, the ownership of the object is left in the caller side, and then destruction of the object must be done by users' responsibility.

It is good for setting "true" as third argument, if the listener object life span is equals to the RTObject's life cycle. On the otehr hand, if callbacks are required to set/unset depending on its situation, the third argument could be "false". In that case, listener objects pointers must be stored to member variables, and set/unset of the listener objects shoud be paerformed throguh RTObject_impl::addPreFsmActionListener()/removePreFsmActionListener() functions.

Constructor & Destructor Documentation

◆ ~PreFsmActionListener()

virtual RTC::PreFsmActionListener::~PreFsmActionListener ( )

virtual

Destructor .

Member Function Documentation

◆ operator()()

virtual void RTC::PreFsmActionListener::operator() ( const char * )

pure virtual

Virtual Callback function.

This is a the Callback function for PreFsmActionListener.

◆ toString()

static const char * RTC::PreFsmActionListener::toString ( PreFsmActionListenerType type )

inlinestatic

Convert PreFsmActionListenerType into the string.

Parameters

type	The target PreFsmActionListenerType for transformation

Returns: Trnasformation result of string representation

References RTC::PRE_FSM_ACTION_LISTENER_NUM.

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

FsmActionListener.h