From 87d29563e3ccdeb7fea0197e262e667ef323ff9c Mon Sep 17 00:00:00 2001 From: Michele Calgaro Date: Sun, 7 Jul 2024 14:56:09 +0900 Subject: Rename utility class nt* related files to equivalent tq* Signed-off-by: Michele Calgaro --- doc/html/tqasciidictiterator.html | 179 ++++++++++++++++++++++++++++++++++++++ 1 file changed, 179 insertions(+) create mode 100644 doc/html/tqasciidictiterator.html (limited to 'doc/html/tqasciidictiterator.html') diff --git a/doc/html/tqasciidictiterator.html b/doc/html/tqasciidictiterator.html new file mode 100644 index 000000000..7de74f80a --- /dev/null +++ b/doc/html/tqasciidictiterator.html @@ -0,0 +1,179 @@ + + + + + +TQAsciiDictIterator Class + + + + + + + +
+ +Home + | +All Classes + | +Main Classes + | +Annotated + | +Grouped Classes + | +Functions +

TQAsciiDictIterator Class Reference

+ +

The TQAsciiDictIterator class provides an iterator for TQAsciiDict collections. +More... +

#include <tqasciidict.h> +

List of all member functions. +

Public Members

+ +

Detailed Description

+ + +The TQAsciiDictIterator class provides an iterator for TQAsciiDict collections. +

+ +

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

Example: +

+    TQAsciiDict<TQLineEdit> fields;
+    fields.insert( "forename", new TQLineEdit( this ) );
+    fields.insert( "surname", new TQLineEdit( this ) );
+    fields.insert( "age", new TQLineEdit( this ) );
+
+    fields["forename"]->setText( "Homer" );
+    fields["surname"]->setText( "Simpson" );
+    fields["age"]->setText( "45" );
+
+    TQAsciiDictIterator<TQLineEdit> it( fields );
+    for( ; it.current(); ++it )
+        cout << it.currentKey() << ": " << it.current()->text() << endl;
+    cout << endl;
+
+    // Output (random order):
+    //  age: 45
+    //  surname: Simpson
+    //  forename: Homer
+
+ +In the example we insert some line edits into a dictionary, then +iterate over the dictionary printing the strings associated with +those line edits. +

Note that the traversal order is arbitrary; you are not guaranteed +any particular order. +

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

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

Member Function Documentation

+

TQAsciiDictIterator::TQAsciiDictIterator ( const TQAsciiDict<type> & dict ) +

+ +

Constructs an iterator for dict. The current iterator item is +set to point on the first item in the dict. + +

TQAsciiDictIterator::~TQAsciiDictIterator () +

+ +

Destroys the iterator. + +

uint TQAsciiDictIterator::count () const +

+ +

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

See also isEmpty(). + +

type * TQAsciiDictIterator::current () const +

+ +

Returns a pointer to the current iterator item. + +

const char * TQAsciiDictIterator::currentKey () const +

+ +

Returns a pointer to the key for the current iterator item. + +

bool TQAsciiDictIterator::isEmpty () const +

+ +

Returns TRUE if the dictionary is empty, i.e. count() == 0, +otherwise returns FALSE. +

See also count(). + +

TQAsciiDictIterator::operator type * () const +

+ +

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

type * TQAsciiDictIterator::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 * TQAsciiDictIterator::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 * TQAsciiDictIterator::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 * TQAsciiDictIterator::toFirst () +

+ +

Sets the current iterator item to point to the first item in the +dictionary and returns a pointer to the item. If the dictionary is +empty it sets the current item to 0 and returns 0. + + +

+This file is part of the TQt toolkit. +Copyright © 1995-2007 +Trolltech. All Rights Reserved.

+ +
Copyright © 2007 +TrolltechTrademarks +
TQt 3.3.8
+
+ -- cgit v1.2.1