Base class to represent iterable objects. More...
#include <wipal/tool/iterable.hh>
Public Types | |
typedef HIDDEN | exact_type |
Iterator types | |
typedef HIDDEN | iterator |
typedef iterator | const_iterator |
Public Member Functions | |
iterator | begin () const |
iterator | end () const |
template<class OutputIterator > | |
void | operator() (const OutputIterator &output) const |
template<class O > | |
void | operator() (const O &o) const |
template<class F > | |
void | for_each (F &f) const |
template<class F > | |
void | for_each (const F &f) const |
Apply a function/functor to each element | |
template<class Functor > | |
void | for_each (Functor &f) const |
template<class Functor > | |
void | for_each (const Functor &f) const |
Downcast methods | |
const exact_type & | exact () const |
exact_type & | exact () |
const exact_type * | exact_ptr () const |
exact_type * | exact_ptr () |
Base class to represent iterable objects.
An iterable oject aggregates elements on which iteration is possible. iterable provides basic mechanisms to permorm this iteration. That is, it provides the iterable::iterator and iterable::const_iterator types, begin() / end() methods, and operator()().
In order to subclass iterable, you must define an iterator type for your iterable class. This type must have a similar constructor:
my_iterator::my_iterator(const my_iterable& e, bool at_end);
The first argument refers to the object you want to iterate on. The second one indicates whether to point the iterator at the begining or past the end of this object's elements.
Once you defined this iterator type, just declare it as part of your iterable class' virtual types :
template <MyIterableParams> struct types< MyIterable<MyIterableParams> > { typedef my_iterator iterator; };