Q3CacheIterator Class Reference

Member Function Documentation

Q3CacheIterator::Q3CacheIterator ( const Q3Cache<type> & cache )

Constructs an iterator for cache. The current iterator item is set to point to the first item in the cache.

Q3CacheIterator::Q3CacheIterator ( const Q3CacheIterator<type> & ci )

Constructs an iterator for the same cache as ci. The new iterator starts at the same item as ci.current(), but moves independently from there on.

bool Q3CacheIterator::atFirst () const

Returns TRUE if the iterator points to the first item in the cache; otherwise returns FALSE. Note that this refers to the iterator's arbitrary ordering, not to the cache's internal least recently used list.

See also toFirst() and atLast().

bool Q3CacheIterator::atLast () const

Returns TRUE if the iterator points to the last item in the cache; otherwise returns FALSE. Note that this refers to the iterator's arbitrary ordering, not to the cache's internal least recently used list.

See also toLast() and atFirst().

uint Q3CacheIterator::count () const

Returns the number of items in the cache on which this iterator operates.

See also isEmpty().

type * Q3CacheIterator::current () const

Returns a pointer to the current iterator item.

QString Q3CacheIterator::currentKey () const

Returns the key for the current iterator item.

bool Q3CacheIterator::isEmpty () const

Returns TRUE if the cache is empty, i.e. count() == 0; otherwise it returns FALSE.

See also count().

type * Q3CacheIterator::toFirst ()

Sets the iterator to point to the first item in the cache and returns a pointer to the item.

Sets the iterator to 0 and returns 0 if the cache is empty.

See also toLast() and isEmpty().

type * Q3CacheIterator::toLast ()

Sets the iterator to point to the last item in the cache and returns a pointer to the item.

Sets the iterator to 0 and returns 0 if the cache is empty.

See also toFirst() and isEmpty().

Q3CacheIterator::operator type * () const

Cast operator. Returns a pointer to the current iterator item. Same as current().

type * Q3CacheIterator::operator() ()

Makes the succeeding item current and returns the original current item.

If the current iterator item was the last item in the cache or if it was 0, 0 is returned.

type * Q3CacheIterator::operator++ ()

Prefix++ makes the iterator point to the item just after current() and makes that the new current item for the iterator. If current() was the last item, operator++() returns 0.

type * Q3CacheIterator::operator+= ( uint jump )

Returns the item jump positions after the current item, or 0 if it is beyond the last item. Makes this the current item.

type * Q3CacheIterator::operator-- ()

Prefix-- makes the iterator point to the item just before current() and makes that the new current item for the iterator. If current() was the first item, operator--() returns 0.

type * Q3CacheIterator::operator-= ( uint jump )

Returns the item jump positions before the current item, or 0 if it is before the first item. Makes this the current item.

Q3CacheIterator<type> & Q3CacheIterator::operator= ( const Q3CacheIterator<type> & ci )

Makes this an iterator for the same cache as ci. The new iterator starts at the same item as ci.current(), but moves independently thereafter.