Q3PtrDictIterator Class Reference
[Qt3Support module]

Detailed Description

The Q3PtrDictIterator class provides an iterator for Q3PtrDict collections.

Q3PtrDictIterator is implemented as a template class. Define a template instance Q3PtrDictIterator<X> to create a dictionary iterator that operates on Q3PtrDict<X> (dictionary of X*).

Example:

 Q3PtrDict<char> fields;

 QLineEdit *le1 = new QLineEdit( this );
 le1->setText( "Simpson" );
 QLineEdit *le2 = new QLineEdit( this );
 le2->setText( "Homer" );
 QLineEdit *le3 = new QLineEdit( this );
 le3->setText( "45" );

 fields.insert( le1, "Surname" );
 fields.insert( le2, "Forename" );
 fields.insert( le3, "Age" );

 Q3PtrDictIterator<char> it( fields );
 for( ; it.current(); ++it ) {
     QLineEdit *le = (QLineEdit)it.currentKey();
     cout << it.current() << ": " << le->text() << endl;
 }
 cout << endl;

 // Output (random order):
 //  Forename: Homer
 //  Age: 45
 //  Surname: Simpson

In the example we insert some line edits into a dictionary, associating a string with each. We then iterate over the dictionary printing the associated strings.

Multiple iterators may independently traverse the same dictionary. A Q3PtrDict knows about all the iterators that are operating on the dictionary. When an item is removed from the dictionary, Q3PtrDict updates all iterators that refer the removed item to point to the next item in the traversing order.

See also Q3PtrDict.

Member Function Documentation