From bd0f3345a938b35ce6a12f6150373b0955b8dd12 Mon Sep 17 00:00:00 2001 From: Timothy Pearson Date: Sun, 10 Jul 2011 15:24:15 -0500 Subject: Add Qt3 development HEAD version --- doc/html/qintdictiterator.html | 176 +++++++++++++++++++++++++++++++++++++++++ 1 file changed, 176 insertions(+) create mode 100644 doc/html/qintdictiterator.html (limited to 'doc/html/qintdictiterator.html') diff --git a/doc/html/qintdictiterator.html b/doc/html/qintdictiterator.html new file mode 100644 index 0000000..d136934 --- /dev/null +++ b/doc/html/qintdictiterator.html @@ -0,0 +1,176 @@ + + + + + +QIntDictIterator Class + + + + + + + +

QIntDictIterator Class Reference

+ +

The QIntDictIterator class provides an iterator for QIntDict collections. +More... +

#include <qintdict.h> +

List of all member functions. +

Public Members

QIntDictIterator ( const QIntDict<type> & dict )
~QIntDictIterator ()
uint count () const
bool isEmpty () const
type * toFirst ()
operator type * () const
type * current () const
long currentKey () const
type * operator() ()
type * operator++ ()
type * operator+= ( uint jump )

Detailed Description

+ + +The QIntDictIterator class provides an iterator for QIntDict collections. +

+ +

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

Example: +

+    QIntDict<QLineEdit> fields;
+    for ( int i = 0; i < 3; i++ )
+        fields.insert( i, new QLineEdit( this ) );
+
+    fields[0]->setText( "Homer" );
+    fields[1]->setText( "Simpson" );
+    fields[2]->setText( "45" );
+
+    QIntDictIterator<QLineEdit> it( fields ); 
+    for ( ; it.current(); ++it )
+        cout << it.currentKey() << ": " << it.current()->text() << endl;
+
+    // Output (random order):
+    //  0: Homer
+    //  1: Simpson
+    //  2: 45
+

+ +

Note that the traversal order is arbitrary; you are not guaranteed the +order shown above. +

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

See also QIntDict, Collection Classes, and Non-GUI Classes. + +

Member Function Documentation

QIntDictIterator::QIntDictIterator ( const QIntDict<type> & dict ) +

+ +

Constructs an iterator for dict. The current iterator item is +set to point to the 'first' item in the dict. The first item +refers to the first item in the dictionary's arbitrary internal +ordering. + +

QIntDictIterator::~QIntDictIterator () +

+ +

Destroys the iterator. + +

uint QIntDictIterator::count () const +

+ +

Returns the number of items in the dictionary this iterator +operates over. +

type * QIntDictIterator::current () const +

+ +

Returns a pointer to the current iterator item. + +

long QIntDictIterator::currentKey () const +

+ +

Returns the key for the current iterator item. + +

bool QIntDictIterator::isEmpty () const +

+ +

Returns TRUE if the dictionary is empty; otherwise eturns FALSE. +

QIntDictIterator::operator type * () const +

+ +

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

type * QIntDictIterator::operator() () +

+ +

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

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

type * QIntDictIterator::operator++ () +

+ +

Prefix ++ makes the succeeding item current and returns the new +current item. +

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

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

+ +

Sets the current item to the item jump positions after the +current item, and returns a pointer to that item. +

If that item is beyond the last item or if the dictionary is +empty, it sets the current item to 0 and returns 0. + +

type * QIntDictIterator::toFirst () +

+ +

Sets the current iterator item to point to the first item in the +dictionary and returns a pointer to the item. The first item +refers to the first item in the dictionary's arbitrary internal +ordering. If the dictionary is empty it sets the current item to +0 and returns 0. + + +

+ +

Trademarks +

Qt 3.3.8

+ -- cgit v1.2.1