1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
|
/****************************************************************************
**
** Definition of QGList and QGListIterator classes
**
** Created : 920624
**
** Copyright (C) 1992-2008 Trolltech ASA. All rights reserved.
**
** This file is part of the tools module of the Qt GUI Toolkit.
**
** This file may be used under the terms of the GNU General
** Public License versions 2.0 or 3.0 as published by the Free
** Software Foundation and appearing in the files LICENSE.GPL2
** and LICENSE.GPL3 included in the packaging of this file.
** Alternatively you may (at your option) use any later version
** of the GNU General Public License if such license has been
** publicly approved by Trolltech ASA (or its successors, if any)
** and the KDE Free Qt Foundation.
**
** Please review the following information to ensure GNU General
** Public Licensing requirements will be met:
** http://trolltech.com/products/qt/licenses/licensing/opensource/.
** If you are unsure which license is appropriate for your use, please
** review the following information:
** http://trolltech.com/products/qt/licenses/licensing/licensingoverview
** or contact the sales department at [email protected].
**
** This file may be used under the terms of the Q Public License as
** defined by Trolltech ASA and appearing in the file LICENSE.QPL
** included in the packaging of this file. Licensees holding valid Qt
** Commercial licenses may use this file in accordance with the Qt
** Commercial License Agreement provided with the Software.
**
** This file is provided "AS IS" with NO WARRANTY OF ANY KIND,
** INCLUDING THE WARRANTIES OF DESIGN, MERCHANTABILITY AND FITNESS FOR
** A PARTICULAR PURPOSE. Trolltech reserves all rights not granted
** herein.
**
**********************************************************************/
#ifndef QGLIST_H
#define QGLIST_H
#ifndef QT_H
#include "qptrcollection.h"
#endif // QT_H
class Q_EXPORT QLNode
{
friend class QGList;
friend class QGListIterator;
friend class QGListStdIterator;
public:
QPtrCollection::Item getData() { return data; }
private:
QPtrCollection::Item data;
QLNode *prev;
QLNode *next;
QLNode( QPtrCollection::Item d ) { data = d; }
};
class QGListIteratorList; // internal helper class
class Q_EXPORT QGList : public QPtrCollection // doubly linked generic list
{
friend class QGListIterator;
friend class QGListIteratorList;
friend class QGVector; // needed by QGVector::toList
public:
uint count() const; // return number of nodes
#ifndef QT_NO_DATASTREAM
QDataStream &read( QDataStream & ); // read list from stream
QDataStream &write( QDataStream & ) const; // write list to stream
#endif
protected:
QGList(); // create empty list
QGList( const QGList & ); // make copy of other list
virtual ~QGList();
QGList &operator=( const QGList & ); // assign from other list
bool operator==( const QGList& ) const;
void inSort( QPtrCollection::Item ); // add item sorted in list
void append( QPtrCollection::Item ); // add item at end of list
bool insertAt( uint index, QPtrCollection::Item ); // add item at i'th position
void relinkNode( QLNode * ); // relink as first item
bool removeNode( QLNode * ); // remove node
bool remove( QPtrCollection::Item = 0 ); // remove item (0=current)
bool removeRef( QPtrCollection::Item = 0 ); // remove item (0=current)
bool removeFirst(); // remove first item
bool removeLast(); // remove last item
bool removeAt( uint ); // remove item at i'th position
bool replaceAt( uint, QPtrCollection::Item ); // replace item at position i with item
QPtrCollection::Item takeNode( QLNode * ); // take out node
QPtrCollection::Item take(); // take out current item
QPtrCollection::Item takeAt( uint index ); // take out item at i'th pos
QPtrCollection::Item takeFirst(); // take out first item
QPtrCollection::Item takeLast(); // take out last item
void sort(); // sort all items;
void clear(); // remove all items
int findRef( QPtrCollection::Item, bool = TRUE ); // find exact item in list
int find( QPtrCollection::Item, bool = TRUE ); // find equal item in list
uint containsRef( QPtrCollection::Item ) const; // get number of exact matches
uint contains( QPtrCollection::Item ) const; // get number of equal matches
QPtrCollection::Item at( uint index ); // access item at i'th pos
int at() const; // get current index
QLNode *currentNode() const; // get current node
QPtrCollection::Item get() const; // get current item
QPtrCollection::Item cfirst() const; // get ptr to first list item
QPtrCollection::Item clast() const; // get ptr to last list item
QPtrCollection::Item first(); // set first item in list curr
QPtrCollection::Item last(); // set last item in list curr
QPtrCollection::Item next(); // set next item in list curr
QPtrCollection::Item prev(); // set prev item in list curr
void toVector( QGVector * ) const; // put items in vector
virtual int compareItems( QPtrCollection::Item, QPtrCollection::Item );
#ifndef QT_NO_DATASTREAM
virtual QDataStream &read( QDataStream &, QPtrCollection::Item & );
virtual QDataStream &write( QDataStream &, QPtrCollection::Item ) const;
#endif
QLNode* begin() const { return firstNode; }
QLNode* end() const { return 0; }
QLNode* erase( QLNode* it );
private:
void prepend( QPtrCollection::Item ); // add item at start of list
void heapSortPushDown( QPtrCollection::Item* heap, int first, int last );
QLNode *firstNode; // first node
QLNode *lastNode; // last node
QLNode *curNode; // current node
int curIndex; // current index
uint numNodes; // number of nodes
QGListIteratorList *iterators; // list of iterators
QLNode *locate( uint ); // get node at i'th pos
QLNode *unlink(); // unlink node
};
inline uint QGList::count() const
{
return numNodes;
}
inline bool QGList::removeFirst()
{
first();
return remove();
}
inline bool QGList::removeLast()
{
last();
return remove();
}
inline int QGList::at() const
{
return curIndex;
}
inline QPtrCollection::Item QGList::at( uint index )
{
QLNode *n = locate( index );
return n ? n->data : 0;
}
inline QLNode *QGList::currentNode() const
{
return curNode;
}
inline QPtrCollection::Item QGList::get() const
{
return curNode ? curNode->data : 0;
}
inline QPtrCollection::Item QGList::cfirst() const
{
return firstNode ? firstNode->data : 0;
}
inline QPtrCollection::Item QGList::clast() const
{
return lastNode ? lastNode->data : 0;
}
/*****************************************************************************
QGList stream functions
*****************************************************************************/
#ifndef QT_NO_DATASTREAM
Q_EXPORT QDataStream &operator>>( QDataStream &, QGList & );
Q_EXPORT QDataStream &operator<<( QDataStream &, const QGList & );
#endif
/*****************************************************************************
QGListIterator class
*****************************************************************************/
class Q_EXPORT QGListIterator // QGList iterator
{
friend class QGList;
friend class QGListIteratorList;
protected:
QGListIterator( const QGList & );
QGListIterator( const QGListIterator & );
QGListIterator &operator=( const QGListIterator & );
~QGListIterator();
bool atFirst() const; // test if at first item
bool atLast() const; // test if at last item
QPtrCollection::Item toFirst(); // move to first item
QPtrCollection::Item toLast(); // move to last item
QPtrCollection::Item get() const; // get current item
QPtrCollection::Item operator()(); // get current and move to next
QPtrCollection::Item operator++(); // move to next item (prefix)
QPtrCollection::Item operator+=(uint); // move n positions forward
QPtrCollection::Item operator--(); // move to prev item (prefix)
QPtrCollection::Item operator-=(uint); // move n positions backward
protected:
QGList *list; // reference to list
private:
QLNode *curNode; // current node in list
};
inline bool QGListIterator::atFirst() const
{
return curNode == list->firstNode;
}
inline bool QGListIterator::atLast() const
{
return curNode == list->lastNode;
}
inline QPtrCollection::Item QGListIterator::get() const
{
return curNode ? curNode->data : 0;
}
class Q_EXPORT QGListStdIterator
{
public:
inline QGListStdIterator( QLNode* n ) : node( n ){}
inline operator QLNode* () { return node; }
protected:
inline QLNode *next() { return node->next; }
QLNode *node;
};
#endif // QGLIST_H
|
