CopperSpice API  1.9.1
QListIterator< T > Class Template Reference

The QListIterator class provides a Java style const iterator for QList and QQueue. More...

Public Methods

 QListIterator (const QList< T > &list)
 
bool findNext (const T &value)
 
bool findPrevious (const T &value)
 
bool hasNext () const
 
bool hasPrevious () const
 
const T & next ()
 
QListIterator & operator= (const QList< T > &list)
 
const T & peekNext () const
 
const T & peekPrevious () const
 
const T & previous ()
 
void toBack ()
 
void toFront ()
 

Detailed Description

template<class T>
class QListIterator< T >

The QListIterator class provides a Java style const iterator for QList and QQueue. For more information refer to Java style iterators.

See also
QMutableListIterator, QList::const_iterator

Constructor & Destructor Documentation

template<class T >
QListIterator< T >::QListIterator ( const QList< T > &  list)
inline

Constructs an iterator for traversing list. The iterator is set to be at the front of the list (before the first item).

See also
operator=()

Method Documentation

template<class T >
bool QListIterator< T >::findNext ( const T &  value)
inline

Searches for value starting from the current iterator position and moving forward. Returns true if the specified value is found, otherwise it returns false. If value is found the iterator is positioned just after the matching item, otherwise the iterator is positioned at the end of the container.

See also
findPrevious()
template<class T >
bool QListIterator< T >::findPrevious ( const T &  value)
inline

Searches for value starting from the current iterator position and moving backward. Returns true if the specified value is found, otherwise it returns false. If value was found the iterator is positioned just before the matching item. Otherwise the iterator is positioned at the beginning of the container.

See also
findNext()
template<class T >
bool QListIterator< T >::hasNext ( ) const
inline

Returns true if there is at least one item ahead of the iterator, i.e. the iterator is not at the back of the container, otherwise returns false.

See also
hasPrevious(), next()
template<class T >
bool QListIterator< T >::hasPrevious ( ) const
inline

Returns true if there is at least one item behind the iterator, i.e. the iterator is not at the front of the container, otherwise returns false.

See also
hasNext(), previous()
template<class T >
const T & QListIterator< T >::next ( )
inline

Returns the next item and advances the iterator by one position.

Calling this function on an iterator located at the back of the container leads to undefined behavior.

See also
hasNext(), peekNext(), previous()
template<class T >
QListIterator & QListIterator< T >::operator= ( const QList< T > &  list)
inline

Makes the iterator operate on list. The iterator is set to be at the front of the list (before the first item).

See also
toFront(), toBack()
template<class T >
const T & QListIterator< T >::peekNext ( ) const
inline

Returns the next item without moving the iterator.

Calling this function on an iterator located at the back of the container leads to undefined behavior.

See also
hasNext(), next(), peekPrevious()
template<class T >
const T & QListIterator< T >::peekPrevious ( ) const
inline

Returns the previous item without moving the iterator.

Calling this function on an iterator located at the front of the container leads to undefined behavior.

See also
hasPrevious(), previous(), peekNext()
template<class T >
const T & QListIterator< T >::previous ( )
inline

Returns the previous item and moves the iterator back by one position.

Calling this function on an iterator located at the front of the container leads to undefined behavior.

See also
hasPrevious(), peekPrevious(), next()
template<class T >
void QListIterator< T >::toBack ( )
inline

Moves the iterator to the back of the container (after the last item).

See also
toFront(), previous()
template<class T >
void QListIterator< T >::toFront ( )
inline

Moves the iterator to the front of the container (before the first item).

See also
toBack(), next()