Reference

StateNode Class Reference

#include <StateNode.h>

Inheritance diagram for StateNode:

[legend]List of all members.

Detailed Description

Recursive data structure - both a state machine controller as well as a node within a state machine itself.

Override setup() to setup your own Transition and StateNode network.

Definition at line 12 of file StateNode.h.

Public Member Functions

StateNode ()

constructor

StateNode (const char *n, StateNode *p=NULL)

constructor, pass a name to use, calls setName(n)

virtual ~StateNode ()

destructor, removes references to its outgoing transitions (be careful of incoming ones - they're still around!), and calls RemoveReference() on subnodes

virtual void addTransition (Transition *trans)

Adds the specified StateTransition to the transition table.

std::vector< Transition * > & getTransitions ()

Returns the std::vector of transitions so you can modify them yourself if need be.

virtual StateNode * addNode (StateNode *node)

Adds a StateNode to nodes so it can be automatically dereferenced later, returns what it's passed (for convenience), calls AddReference() on node.

std::vector< StateNode * > & getNodes ()

Returns the std::vector of nodes so you can modify them yourself if need be.

void setRetain (bool f)

Sets the retain flag - if not retained, will RemoveReference() subnodes upon DoStop() and recreate them on DoStart (by calling setup()) - may be too expensive to be worth saving memory...

virtual void DoStart ()

Transitions should call this when you are entering the state, so it can enable its transitions.

virtual void setup ()

This is called by DoStart() when you should setup the network of subnodes.

virtual void DoStop ()

Transitions should call this when you are leaving the state, so it can disable its transitions.

virtual void teardown ()

This is called by DoStop() when you should destruct subnodes.

void setName (const std::string &n)

set name to n. Makes a copy of n, so you can throw it away later.

virtual std::string getName () const

returns name of StateNode

virtual std::string getDescription () const

returns name again (you should override this for top-level nodes to give users better descriptions)

Protected Member Functions

virtual void transitionTo (StateNode *n)

called by a subnode when it is being DoStart()'ed

virtual void transitionFrom (StateNode *n)

called by a subnode when it is being DoStop()'ed

Protected Attributes

StateNode * parent

pointer to the machine that contains this node

std::vector< Transition * > transitions

a vector of outgoing transitions

bool issetup

this is set to true if the network has been setup but not destroyed (i.e. don't need to call setupSubNodes again)

bool retain

this is set to true if the network should be retained between activations. Otherwise it's dereferenced upon DoStop(). (or at least RemoveReference() is called on subnodes)

std::vector< StateNode * > nodes

vector of StateNodes, just so they can be dereferenced again on DoStop() (unless retained) or ~StateNode()

std::string name

holds the name of the Node/Machine

Private Member Functions

StateNode (const StateNode &node)

don't call this

StateNode operator= (const StateNode &node)

don't call this

Constructor & Destructor Documentation

StateNode::StateNode ( ) [inline]

constructor

Definition at line 15 of file StateNode.h.
References issetup, name, nodes, parent, retain, and transitions.

StateNode::StateNode ( const char * n,

StateNode * p = NULL

) [inline]

constructor, pass a name to use, calls setName(n)

Definition at line 18 of file StateNode.h.
References issetup, name, nodes, parent, retain, setName(), and transitions.