Q3IntDict Class Reference
[Qt3Support module]

Detailed Description

The Q3IntDict class is a template class that provides a dictionary based on long keys.

Q3IntDict is implemented as a template class. Define a template instance Q3IntDict<X> to create a dictionary that operates on pointers to X (X*).

A dictionary is a collection of key-value pairs. The key is an long used for insertion, removal and lookup. The value is a pointer. Dictionaries provide very fast insertion and lookup.

Example:

 Q3IntDict<QLineEdit> fields; // long int keys, QLineEdit* values
 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" );

 Q3IntDictIterator<QLineEdit> it( fields );
 for ( ; it.current(); ++it )
     cout << it.currentKey() << ": " << it.current()->text() << endl;

 for ( int i = 0; i < 3; i++ )
     cout << fields[i]->text() << " "; // Prints "Homer Simpson 45"
 cout << endl;

 fields.remove( 1 ); // Does not delete the line edit
 for ( int i = 0; i < 3; i++ )
     if ( fields[i] )
         cout << fields[i]->text() << " "; // Prints "Homer 45"

See Q3Dict for full details, including the choice of dictionary size, and how deletions are handled.

See also Q3IntDictIterator, Q3Dict, Q3AsciiDict, and Q3PtrDict.

Member Function Documentation

 Q3IntDict<char> dict;
 //      ...
 if ( dict.find(key) )
     dict.remove( key );
 dict.insert( key, item );