|
Packit |
1c1d7e |
/****************************************************************************
|
|
Packit |
1c1d7e |
**
|
|
Packit |
1c1d7e |
**
|
|
Packit |
1c1d7e |
** Definition of QGList and QGListIterator classes
|
|
Packit |
1c1d7e |
**
|
|
Packit |
1c1d7e |
** Created : 920624
|
|
Packit |
1c1d7e |
**
|
|
Packit |
1c1d7e |
** Copyright (C) 1992-2000 Trolltech AS. All rights reserved.
|
|
Packit |
1c1d7e |
**
|
|
Packit |
1c1d7e |
** This file is part of the tools module of the Qt GUI Toolkit.
|
|
Packit |
1c1d7e |
**
|
|
Packit |
1c1d7e |
** This file may be distributed under the terms of the Q Public License
|
|
Packit |
1c1d7e |
** as defined by Trolltech AS of Norway and appearing in the file
|
|
Packit |
1c1d7e |
** LICENSE.QPL included in the packaging of this file.
|
|
Packit |
1c1d7e |
**
|
|
Packit |
1c1d7e |
** This file may be distributed and/or modified under the terms of the
|
|
Packit |
1c1d7e |
** GNU General Public License version 2 as published by the Free Software
|
|
Packit |
1c1d7e |
** Foundation and appearing in the file LICENSE.GPL included in the
|
|
Packit |
1c1d7e |
** packaging of this file.
|
|
Packit |
1c1d7e |
**
|
|
Packit |
1c1d7e |
** Licensees holding valid Qt Enterprise Edition or Qt Professional Edition
|
|
Packit |
1c1d7e |
** licenses may use this file in accordance with the Qt Commercial License
|
|
Packit |
1c1d7e |
** Agreement provided with the Software.
|
|
Packit |
1c1d7e |
**
|
|
Packit |
1c1d7e |
** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
|
|
Packit |
1c1d7e |
** WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
|
|
Packit |
1c1d7e |
**
|
|
Packit |
1c1d7e |
** See http://www.trolltech.com/pricing.html or email sales@trolltech.com for
|
|
Packit |
1c1d7e |
** information about Qt Commercial License Agreements.
|
|
Packit |
1c1d7e |
** See http://www.trolltech.com/qpl/ for QPL licensing information.
|
|
Packit |
1c1d7e |
** See http://www.trolltech.com/gpl/ for GPL licensing information.
|
|
Packit |
1c1d7e |
**
|
|
Packit |
1c1d7e |
** Contact info@trolltech.com if any conditions of this licensing are
|
|
Packit |
1c1d7e |
** not clear to you.
|
|
Packit |
1c1d7e |
**
|
|
Packit |
1c1d7e |
**********************************************************************/
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
#ifndef QGLIST_H
|
|
Packit |
1c1d7e |
#define QGLIST_H
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
#ifndef QT_H
|
|
Packit |
1c1d7e |
#include "qcollection.h"
|
|
Packit |
1c1d7e |
#endif // QT_H
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
/*****************************************************************************
|
|
Packit |
1c1d7e |
QLNode class (internal doubly linked list node)
|
|
Packit |
1c1d7e |
*****************************************************************************/
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
class Q_EXPORT QLNode
|
|
Packit |
1c1d7e |
{
|
|
Packit |
1c1d7e |
friend class QGList;
|
|
Packit |
1c1d7e |
friend class QGListIterator;
|
|
Packit |
1c1d7e |
public:
|
|
Packit |
1c1d7e |
QCollection::Item getData() { return data; }
|
|
Packit |
1c1d7e |
private:
|
|
Packit |
1c1d7e |
QCollection::Item data;
|
|
Packit |
1c1d7e |
QLNode *prev;
|
|
Packit |
1c1d7e |
QLNode *next;
|
|
Packit |
1c1d7e |
QLNode( QCollection::Item d ) { data = d; }
|
|
Packit |
1c1d7e |
};
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
/*****************************************************************************
|
|
Packit |
1c1d7e |
QGList class
|
|
Packit |
1c1d7e |
*****************************************************************************/
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
class Q_EXPORT QGList : public QCollection // doubly linked generic list
|
|
Packit |
1c1d7e |
{
|
|
Packit |
1c1d7e |
friend class QGListIterator;
|
|
Packit |
1c1d7e |
friend class QGVector; // needed by QGVector::toList
|
|
Packit |
1c1d7e |
public:
|
|
Packit |
1c1d7e |
uint count() const; // return number of nodes
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
#ifndef QT_NO_DATASTREAM
|
|
Packit |
1c1d7e |
QDataStream &read( QDataStream & ); // read list from stream
|
|
Packit |
1c1d7e |
QDataStream &write( QDataStream & ) const; // write list to stream
|
|
Packit |
1c1d7e |
#endif
|
|
Packit |
1c1d7e |
protected:
|
|
Packit |
1c1d7e |
QGList(); // create empty list
|
|
Packit |
1c1d7e |
QGList( const QGList & ); // make copy of other list
|
|
Packit |
1c1d7e |
virtual ~QGList();
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
QGList &operator=( const QGList & ); // assign from other list
|
|
Packit |
1c1d7e |
bool operator==( const QGList& ) const;
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
void inSort( QCollection::Item ); // add item sorted in list
|
|
Packit |
1c1d7e |
void append( QCollection::Item ); // add item at end of list
|
|
Packit |
1c1d7e |
bool insertAt( uint index, QCollection::Item ); // add item at i'th position
|
|
Packit |
1c1d7e |
void relinkNode( QLNode * ); // relink as first item
|
|
Packit |
1c1d7e |
bool removeNode( QLNode * ); // remove node
|
|
Packit |
1c1d7e |
bool remove( QCollection::Item = 0 ); // remove item (0=current)
|
|
Packit |
1c1d7e |
bool removeRef( QCollection::Item = 0 ); // remove item (0=current)
|
|
Packit |
1c1d7e |
bool removeFirst(); // remove first item
|
|
Packit |
1c1d7e |
bool removeLast(); // remove last item
|
|
Packit |
1c1d7e |
bool removeAt( uint index ); // remove item at i'th position
|
|
Packit |
1c1d7e |
QCollection::Item takeNode( QLNode * ); // take out node
|
|
Packit |
1c1d7e |
QCollection::Item take(); // take out current item
|
|
Packit |
1c1d7e |
QCollection::Item takeAt( uint index ); // take out item at i'th pos
|
|
Packit |
1c1d7e |
QCollection::Item takeFirst(); // take out first item
|
|
Packit |
1c1d7e |
QCollection::Item takeLast(); // take out last item
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
void sort(); // sort all items;
|
|
Packit |
1c1d7e |
void clear(); // remove all items
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
int findRef( QCollection::Item, bool = TRUE ); // find exact item in list
|
|
Packit |
1c1d7e |
int find( QCollection::Item, bool = TRUE ); // find equal item in list
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
uint containsRef( QCollection::Item ) const; // get number of exact matches
|
|
Packit |
1c1d7e |
uint contains( QCollection::Item ) const; // get number of equal matches
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
QCollection::Item at( uint index ); // access item at i'th pos
|
|
Packit |
1c1d7e |
int at() const; // get current index
|
|
Packit |
1c1d7e |
QLNode *currentNode() const; // get current node
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
QCollection::Item get() const; // get current item
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
QCollection::Item cfirst() const; // get ptr to first list item
|
|
Packit |
1c1d7e |
QCollection::Item clast() const; // get ptr to last list item
|
|
Packit |
1c1d7e |
QCollection::Item first(); // set first item in list curr
|
|
Packit |
1c1d7e |
QCollection::Item last(); // set last item in list curr
|
|
Packit |
1c1d7e |
QCollection::Item next(); // set next item in list curr
|
|
Packit |
1c1d7e |
QCollection::Item prev(); // set prev item in list curr
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
void toVector( QGVector * ) const; // put items in vector
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
virtual int compareItems( QCollection::Item, QCollection::Item );
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
#ifndef QT_NO_DATASTREAM
|
|
Packit |
1c1d7e |
virtual QDataStream &read( QDataStream &, QCollection::Item & );
|
|
Packit |
1c1d7e |
virtual QDataStream &write( QDataStream &, QCollection::Item ) const;
|
|
Packit |
1c1d7e |
#endif
|
|
Packit |
1c1d7e |
private:
|
|
Packit |
1c1d7e |
void prepend( QCollection::Item ); // add item at start of list
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
void heapSortPushDown( QCollection::Item* heap, int first, int last );
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
QLNode *firstNode; // first node
|
|
Packit |
1c1d7e |
QLNode *lastNode; // last node
|
|
Packit |
1c1d7e |
QLNode *curNode; // current node
|
|
Packit |
1c1d7e |
int curIndex; // current index
|
|
Packit |
1c1d7e |
uint numNodes; // number of nodes
|
|
Packit |
1c1d7e |
QGList *iterators; // list of iterators
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
QLNode *locate( uint ); // get node at i'th pos
|
|
Packit |
1c1d7e |
QLNode *unlink(); // unlink node
|
|
Packit |
1c1d7e |
};
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
inline uint QGList::count() const
|
|
Packit |
1c1d7e |
{
|
|
Packit |
1c1d7e |
return numNodes;
|
|
Packit |
1c1d7e |
}
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
inline bool QGList::removeFirst()
|
|
Packit |
1c1d7e |
{
|
|
Packit |
1c1d7e |
first();
|
|
Packit |
1c1d7e |
return remove();
|
|
Packit |
1c1d7e |
}
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
inline bool QGList::removeLast()
|
|
Packit |
1c1d7e |
{
|
|
Packit |
1c1d7e |
last();
|
|
Packit |
1c1d7e |
return remove();
|
|
Packit |
1c1d7e |
}
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
inline int QGList::at() const
|
|
Packit |
1c1d7e |
{
|
|
Packit |
1c1d7e |
return curIndex;
|
|
Packit |
1c1d7e |
}
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
inline QCollection::Item QGList::at( uint index )
|
|
Packit |
1c1d7e |
{
|
|
Packit |
1c1d7e |
QLNode *n = locate( index );
|
|
Packit |
1c1d7e |
return n ? n->data : 0;
|
|
Packit |
1c1d7e |
}
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
inline QLNode *QGList::currentNode() const
|
|
Packit |
1c1d7e |
{
|
|
Packit |
1c1d7e |
return curNode;
|
|
Packit |
1c1d7e |
}
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
inline QCollection::Item QGList::get() const
|
|
Packit |
1c1d7e |
{
|
|
Packit |
1c1d7e |
return curNode ? curNode->data : 0;
|
|
Packit |
1c1d7e |
}
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
inline QCollection::Item QGList::cfirst() const
|
|
Packit |
1c1d7e |
{
|
|
Packit |
1c1d7e |
return firstNode ? firstNode->data : 0;
|
|
Packit |
1c1d7e |
}
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
inline QCollection::Item QGList::clast() const
|
|
Packit |
1c1d7e |
{
|
|
Packit |
1c1d7e |
return lastNode ? lastNode->data : 0;
|
|
Packit |
1c1d7e |
}
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
/*****************************************************************************
|
|
Packit |
1c1d7e |
QGList stream functions
|
|
Packit |
1c1d7e |
*****************************************************************************/
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
#ifndef QT_NO_DATASTREAM
|
|
Packit |
1c1d7e |
Q_EXPORT QDataStream &operator>>( QDataStream &, QGList & );
|
|
Packit |
1c1d7e |
Q_EXPORT QDataStream &operator<<( QDataStream &, const QGList & );
|
|
Packit |
1c1d7e |
#endif
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
/*****************************************************************************
|
|
Packit |
1c1d7e |
QGListIterator class
|
|
Packit |
1c1d7e |
*****************************************************************************/
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
class Q_EXPORT QGListIterator // QGList iterator
|
|
Packit |
1c1d7e |
{
|
|
Packit |
1c1d7e |
friend class QGList;
|
|
Packit |
1c1d7e |
protected:
|
|
Packit |
1c1d7e |
QGListIterator( const QGList & );
|
|
Packit |
1c1d7e |
QGListIterator( const QGListIterator & );
|
|
Packit |
1c1d7e |
QGListIterator &operator=( const QGListIterator & );
|
|
Packit |
1c1d7e |
~QGListIterator();
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
bool atFirst() const; // test if at first item
|
|
Packit |
1c1d7e |
bool atLast() const; // test if at last item
|
|
Packit |
1c1d7e |
QCollection::Item toFirst(); // move to first item
|
|
Packit |
1c1d7e |
QCollection::Item toLast(); // move to last item
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
QCollection::Item get() const; // get current item
|
|
Packit |
1c1d7e |
QCollection::Item operator()(); // get current and move to next
|
|
Packit |
1c1d7e |
QCollection::Item operator++(); // move to next item (prefix)
|
|
Packit |
1c1d7e |
QCollection::Item operator+=(uint); // move n positions forward
|
|
Packit |
1c1d7e |
QCollection::Item operator--(); // move to prev item (prefix)
|
|
Packit |
1c1d7e |
QCollection::Item operator-=(uint); // move n positions backward
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
protected:
|
|
Packit |
1c1d7e |
QGList *list; // reference to list
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
private:
|
|
Packit |
1c1d7e |
QLNode *curNode; // current node in list
|
|
Packit |
1c1d7e |
};
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
inline bool QGListIterator::atFirst() const
|
|
Packit |
1c1d7e |
{
|
|
Packit |
1c1d7e |
return curNode == list->firstNode;
|
|
Packit |
1c1d7e |
}
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
inline bool QGListIterator::atLast() const
|
|
Packit |
1c1d7e |
{
|
|
Packit |
1c1d7e |
return curNode == list->lastNode;
|
|
Packit |
1c1d7e |
}
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
inline QCollection::Item QGListIterator::get() const
|
|
Packit |
1c1d7e |
{
|
|
Packit |
1c1d7e |
return curNode ? curNode->data : 0;
|
|
Packit |
1c1d7e |
}
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
|
|
Packit |
1c1d7e |
#endif // QGLIST_H
|