spot  1.2.6
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Groups Pages
Public Member Functions | List of all members
spot::ta_succ_iterator Class Referenceabstract

Iterate over the successors of a state. More...

#include <ta/ta.hh>

Inheritance diagram for spot::ta_succ_iterator:
Inheritance graph
Collaboration diagram for spot::ta_succ_iterator:
Collaboration graph

Public Member Functions

virtual void first ()=0
 Position the iterator on the first successor (if any). More...
 
virtual void next ()=0
 Jump to the next successor (if any). More...
 
virtual bool done () const =0
 Check whether the iteration is finished. More...
 
virtual statecurrent_state () const =0
 Get the state of the current successor. More...
 
virtual bdd current_condition () const =0
 Get the changeset on the transition leading to current successor. More...
 
bdd current_acceptance_conditions () const =0
 Get the acceptance conditions on the transition leading to this successor. More...
 

Detailed Description

Iterate over the successors of a state.

This class provides the basic functionalities required to iterate over the successors of a state, as well as querying transition labels. Because transitions are never explicitely encoded, labels (conditions and acceptance conditions) can only be queried while iterating over the successors.

Member Function Documentation

bdd spot::ta_succ_iterator::current_acceptance_conditions ( ) const
pure virtual

Get the acceptance conditions on the transition leading to this successor.

Implements spot::tgba_succ_iterator.

Implemented in spot::ta_explicit_succ_iterator, and spot::ta_succ_iterator_product.

virtual bdd spot::ta_succ_iterator::current_condition ( ) const
pure virtual

Get the changeset on the transition leading to current successor.

This is a boolean function of atomic propositions.

Implements spot::tgba_succ_iterator.

Implemented in spot::ta_explicit_succ_iterator, and spot::ta_succ_iterator_product.

virtual state* spot::ta_succ_iterator::current_state ( ) const
pure virtual

Get the state of the current successor.

Note that the same state may occur at different points in the iteration. These actually correspond to the same destination. It just means there were several transitions, with different conditions, leading to the same state.

The returned state should be destroyed (see state::destroy) by the caller after it is no longer used.

Implements spot::tgba_succ_iterator.

Implemented in spot::ta_explicit_succ_iterator, and spot::ta_succ_iterator_product.

virtual bool spot::ta_succ_iterator::done ( ) const
pure virtual

Check whether the iteration is finished.

This function should be called after any call to first() or next() and before any enquiry about the current state.

The usual way to do this is with a for loop.

for (s->first(); !s->done(); s->next())
  ...  

Implements spot::tgba_succ_iterator.

Implemented in spot::ta_explicit_succ_iterator, and spot::ta_succ_iterator_product.

virtual void spot::ta_succ_iterator::first ( )
pure virtual

Position the iterator on the first successor (if any).

This method can be called several times to make multiple passes over successors.

Warning
One should always call done() to ensure there is a successor, even after first(). A common trap is to assume that there is at least one successor: this is wrong.

Implements spot::tgba_succ_iterator.

Implemented in spot::ta_explicit_succ_iterator, and spot::ta_succ_iterator_product.

virtual void spot::ta_succ_iterator::next ( )
pure virtual

Jump to the next successor (if any).

Warning
Again, one should always call done() to ensure there is a successor.

Implements spot::tgba_succ_iterator.

Implemented in spot::ta_explicit_succ_iterator, and spot::ta_succ_iterator_product.


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

Please direct any question, comment, or bug report to the Spot mailing list at spot@lrde.epita.fr.
Generated on Sat Dec 6 2014 12:28:44 for spot by doxygen 1.8.4