Ogre::VectorIterator< T > Class Template Reference

Wraps iteration over a vector. More...

#include <OgreIteratorWrappers.h>

List of all members.

Public Types

typedef T::value_type ValueType

Public Member Functions

 VectorIterator (typename T::iterator start, typename T::iterator end)
 Constructor.
 VectorIterator (T &c)
 Constructor.
bool hasMoreElements (void) const
 Returns true if there are more items in the collection.
T::value_type getNext (void)
 Returns the next element in the collection, and advances to the next.
T::value_type peekNext (void)
 Returns the next element in the collection, without advancing to the next.
T::pointer peekNextPtr (void)
 Returns a pointer to the next element in the collection, without advancing to the next afterwards.
void moveNext (void)
 Moves the iterator on one element.

Private Member Functions

 VectorIterator ()
 Private constructor since only the parameterised constructor should be used.

Private Attributes

T::iterator mCurrent
T::iterator mEnd


Detailed Description

template<class T>
class Ogre::VectorIterator< T >

Wraps iteration over a vector.

Remarks:
This class is here just to allow clients to iterate over an internal vector of a class without having to have access to the vector itself (typically to iterate you need both the iterator and the end() iterator to test for the end condition, which is messy). No updates are allowed through this interface, it is purely for iterating and reading.
Note that like STL iterators, these iterators are only valid whilst no updates are made to the underlying collection. You should not attempt to use this iterator if a change is made to the collection. In fact, treat this iterator as a transient object, do NOT store it and try to use it repeatedly.

Definition at line 51 of file OgreIteratorWrappers.h.


Member Typedef Documentation

template<class T>
typedef T::value_type Ogre::VectorIterator< T >::ValueType

Definition at line 57 of file OgreIteratorWrappers.h.


Constructor & Destructor Documentation

template<class T>
Ogre::VectorIterator< T >::VectorIterator (  )  [private]

Private constructor since only the parameterised constructor should be used.

Definition at line 57 of file OgreIteratorWrappers.h.

template<class T>
Ogre::VectorIterator< T >::VectorIterator ( typename T::iterator  start,
typename T::iterator  end 
)

Constructor.

Remarks:
Provide a start and end iterator to initialise.

Definition at line 65 of file OgreIteratorWrappers.h.

template<class T>
Ogre::VectorIterator< T >::VectorIterator ( T &  c  )  [explicit]

Constructor.

Remarks:
Provide a container to initialise.

Definition at line 74 of file OgreIteratorWrappers.h.


Member Function Documentation

template<class T>
bool Ogre::VectorIterator< T >::hasMoreElements ( void   )  const

Returns true if there are more items in the collection.

Definition at line 80 of file OgreIteratorWrappers.h.

References Ogre::VectorIterator< T >::mCurrent, and Ogre::VectorIterator< T >::mEnd.

template<class T>
T::value_type Ogre::VectorIterator< T >::getNext ( void   ) 

Returns the next element in the collection, and advances to the next.

Definition at line 86 of file OgreIteratorWrappers.h.

References Ogre::VectorIterator< T >::mCurrent.

template<class T>
T::value_type Ogre::VectorIterator< T >::peekNext ( void   ) 

Returns the next element in the collection, without advancing to the next.

Definition at line 91 of file OgreIteratorWrappers.h.

References Ogre::VectorIterator< T >::mCurrent.

template<class T>
T::pointer Ogre::VectorIterator< T >::peekNextPtr ( void   ) 

Returns a pointer to the next element in the collection, without advancing to the next afterwards.

Definition at line 96 of file OgreIteratorWrappers.h.

template<class T>
void Ogre::VectorIterator< T >::moveNext ( void   ) 

Moves the iterator on one element.

Definition at line 101 of file OgreIteratorWrappers.h.

References Ogre::VectorIterator< T >::mCurrent.


Member Data Documentation

template<class T>
T::iterator Ogre::VectorIterator< T >::mCurrent [private]

template<class T>
T::iterator Ogre::VectorIterator< T >::mEnd [private]

Definition at line 55 of file OgreIteratorWrappers.h.

Referenced by Ogre::VectorIterator< T >::hasMoreElements().


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

Copyright © 2008 Torus Knot Software Ltd
Creative Commons License
This work is licensed under a Creative Commons Attribution-ShareAlike 2.5 License.
Last modified Sun Sep 27 22:03:51 2009