scxml4cpp::Event Class Reference

#include <Event.h>

Inheritance diagram for scxml4cpp::Event:

Public Types
enum	EventType {   CALL_EVENT = 0 , CHANGE_EVENT , SIGNAL_EVENT , TIME_EVENT ,   ERROR_EVENT }
enum	EventStatus {   TOBEPROCESSED = 0 , PROCESSED , IGNORED , REJECTED ,   DEFERRED }

Public Member Functions
	Event ()
	Event (const std::string &id, const EventType type)
	Event (const Event &e)
Event &	operator= (const Event &e)
virtual	~Event ()
const std::string &	getId () const
const EventType	getType () const
const EventStatus	getStatus () const
void *	getPayload () const
void	setId (const std::string &id)
void	setType (const EventType type)
void	setStatus (const EventStatus status)
void	setPayload (void *payload)
bool	isNull () const

Detailed Description

This class represents an event processed by the State Machine interpreter.

Events can trigger transitions and therefore change of state.

This implementation leaves the possibility to define an event type which is borrowed from UML (Call, Change, Signal, Time, Error).

The type (mType) is used, together with the identifier (mId) to match an event in a transition (e.g. if the event identifier is identical but the type is different, it is considered a different event).

The class provides also the possibility to define whether the event has been processed, ignored, rejected, deferred, or still to be handled via the status attribute.

TODO payload should have type shared_ptr.

Member Enumeration Documentation

EventStatus

enum scxml4cpp::Event::EventStatus

Current status of the event.

Enumerator
TOBEPROCESSED
PROCESSED
IGNORED
REJECTED
DEFERRED

EventType

enum scxml4cpp::Event::EventType

Type of event.

Enumerator
CALL_EVENT
CHANGE_EVENT
SIGNAL_EVENT
TIME_EVENT
ERROR_EVENT

Constructor & Destructor Documentation

Event() [1/3]

Event::Event

(

)

Creates a default event object with

• empty identifier
• of type CHANGE_EVENT
• of status TOBEPROCESSED
• with NULL payload

Event() [2/3]

Event::Event	(	const std::string &	id,
		const EventType	type
	)

Creates an event object using the given parameters.

Parameters

id	Event identifier.
type	Event type.

Status is initialized to TOBEPROCESSED and the payload to NULL.

Event() [3/3]

Event::Event

(

const Event &

e

)

Copy constructor.

~Event()

Event::~Event ( )

virtual

Destroy an event object.

This destructor does not deallocate memory.

Member Function Documentation

getId()

const std::string & Event::getId

(

)

const

Returns

The event identifier.

getPayload()

void * Event::getPayload

(

)

const

Returns

A pointer to a payload.

getStatus()

const Event::EventStatus Event::getStatus

(

)

const

Returns

Whether the event has been processed or not.

getType()

const Event::EventType Event::getType

(

)

const

Returns

The type of event.

isNull()

bool Event::isNull

(

)

const

Checks whether an event is NULL. A NULL event is an event with empty identifier.

Returns

true if the event is a NULL event, false otherwise.

operator=()

Event & Event::operator=

(

const Event &

e

)

Assignment operator.

setId()

void Event::setId

(

const std::string &

id

)

Set the event identifier.

Parameters

id	Event identifier.

setPayload()

void Event::setPayload

(

void *

payload

)

Set the pointer to an event payload.

Parameters

payload

Pointer to a payload.

setStatus()

void Event::setStatus

(

const EventStatus

status

)

Set the event status.

Parameters

status

Event status: whether the event has been processed or not.

setType()

void Event::setType

(

const EventType

type

)

Set the event type.

Parameters

type	Event type.

---

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

• scxml4cpp/engine/src/include/scxml4cpp/Event.h
• scxml4cpp/engine/src/Event.cpp