SourcePro® API Reference Guide

 
List of all members | Public Member Functions
RWHashTableConstIterator Class Reference

Allows sequential access to all the elements of RWHashTable and, as a const iterator, it does not change anything in the underlying data structure. More...

#include <rw/hashtab.h>

Inheritance diagram for RWHashTableConstIterator:
RWConstIterator RWSetConstIterator RWHashDictionaryConstIterator

Public Member Functions

 RWHashTableConstIterator (const RWHashTable &h)
 
 RWHashTableConstIterator (const RWHashTableConstIterator &)
 
 RWHashTableConstIterator (const RWHashTableIterator &it)
 
virtual const RWCollectablefindNext (const RWCollectable *target)
 
virtual const RWCollectablekey () const
 
virtual const RWCollectableoperator() ()
 
virtual void reset ()
 

Detailed Description

One of two iterators for class RWHashTable. As a const iterator, it does not change anything in the underlying data structure.

This iterator allows sequential access to all the elements of RWHashTable.

Note
An RWHashTable is unordered, elements are not accessed in any particular order.

As with all Rogue Wave iterators, the "current item" is undefined immediately after construction – you must define it by using operator()() or some other (valid) operation.

Once the iterator has advanced beyond the end of the collection it is no longer valid – continuing to use it brings undefined results.

Synopsis
#include <rw/hashtab.h>
Persistence
None

Constructor & Destructor Documentation

RWHashTableConstIterator::RWHashTableConstIterator ( const RWHashTable h)

Constructs a const iterator for an RWHashTable. After construction, the position of the iterator is undefined.

RWHashTableConstIterator::RWHashTableConstIterator ( const RWHashTableConstIterator )

Copy constructor. After construction, the position of the iterator is undefined.

RWHashTableConstIterator::RWHashTableConstIterator ( const RWHashTableIterator it)
inline

Constructs a const iterator from an iterator. After construction, the position of the const iterator is undefined.

Member Function Documentation

virtual const RWCollectable* RWHashTableConstIterator::findNext ( const RWCollectable target)
virtual

Moves the iterator to the next item which isEqual() to the item pointed to by target and returns it.

Implements RWConstIterator.

Reimplemented in RWHashDictionaryConstIterator.

virtual const RWCollectable* RWHashTableConstIterator::key ( ) const
virtual

Returns the item at the current iterator position.

Implements RWConstIterator.

Reimplemented in RWHashDictionaryConstIterator.

virtual const RWCollectable* RWHashTableConstIterator::operator() ( )
virtual

Advances the iterator and returns the next item, or rwnil if the end of the collection has been reached.

Implements RWConstIterator.

Reimplemented in RWHashDictionaryConstIterator.

virtual void RWHashTableConstIterator::reset ( )
virtual

Resets the iterator to the state it had immediately after construction.

Implements RWConstIterator.

Reimplemented in RWHashDictionaryConstIterator, and RWSetConstIterator.

Copyright © 2023 Rogue Wave Software, Inc., a Perforce company. All Rights Reserved.