![]() |
| ||
Classes - Annotated - Tree - Functions - Home - Structure |
The QDictIterator class provides an iterator for QDict collections. More...
#include <qdict.h>
QDictIterator is implemented as a template class. Define a template instance QDictIterator<X> to create a dictionary iterator that operates on QDict<X> (dictionary of X*).
The traversal order is arbitrary; when we speak of the "first", "last" and "next" item we are talking in terms of this arbitrary order.
Multiple iterators may independently traverse the same dictionary. A QDict knows about all iterators that are operating on the dictionary. When an item is removed from the dictionary, QDict update all iterators that are referring to the removed item to point to the next item in the traversal order.
Example:
QDict<QWidget> widgets; // ... widgets.insert( "OK", okButton ); widgets.insert( "Cancel", cancelButton ); widgets.insert( "Options", optionsCombobox ); // ... QStringList buttonList; QDictIterator<QWidget> it( widgets ); for ( ; it.current(); ++it ) if ( it.current()->inherits( "QPushButton" ) ) buttonList += it.currentKey();In the example we insert some widgets into a dictionary, then iterate over the dictionary adding the string keys for those widgets which are derived from QPushButton, into a list.
See also QDict and Collection Classes.
See also isEmpty().
See also count().
If the current iterator item was the last item in the dictionary or if it was 0, 0 is returned.
If the current iterator item was the last item in the dictionary or if it was 0, 0 is returned.
If the dictionary is empty it sets the current item to 0 and returns 0.
Search the documentation, FAQ, qt-interest archive and more (uses
www.trolltech.com):
This file is part of the Qt toolkit, copyright © 1995-2001 Trolltech, all rights reserved.
Copyright © 2001 Trolltech | Trademarks | Qt version 3.0.0-beta2
|