avl.h@ 19559

Last change on this file since 19559 was 19559, checked in by vboxsync, 16 years ago
IPRT: Coded up the debug address space, adding a RTUINTPTR AVL range tree in the process. Stubbed the debug module interpreter.
Property svn:eol-style set to `native` Property svn:keywords set to `Author Date Id Revision`
File size: 35.4 KB

Line
1	/** @file
2	* IPRT - AVL Trees.
3	*/
4
5	/*
6	* Copyright (C) 1999-2003 knut st. osmundsen <bird-src-spam@anduin.net>
7	*
8	* This file is part of VirtualBox Open Source Edition (OSE), as
9	* available from http://www.virtualbox.org. This file is free software;
10	* you can redistribute it and/or modify it under the terms of the GNU
11	* General Public License (GPL) as published by the Free Software
12	* Foundation, in version 2 as it comes in the "COPYING" file of the
13	* VirtualBox OSE distribution. VirtualBox OSE is distributed in the
14	* hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
15	*
16	* The contents of this file may alternatively be used under the terms
17	* of the Common Development and Distribution License Version 1.0
18	* (CDDL) only, as it comes in the "COPYING.CDDL" file of the
19	* VirtualBox OSE distribution, in which case the provisions of the
20	* CDDL are applicable instead of those of the GPL.
21	*
22	* You may elect to license modified versions of this file under the
23	* terms and conditions of either the GPL or the CDDL or both.
24	*
25	* Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa
26	* Clara, CA 95054 USA or visit http://www.sun.com if you need
27	* additional information or have any questions.
28	*/
29
30	#ifndef ___iprt_avl_h
31	#define ___iprt_avl_h
32
33	#include <iprt/cdefs.h>
34	#include <iprt/types.h>
35
36	__BEGIN_DECLS
37
38	/** @defgroup grp_rt_avl RTAvl - AVL Trees
39	* @ingroup grp_rt
40	* @{
41	*/
42
43
44	/** AVL tree of void pointers.
45	* @{
46	*/
47
48	/**
49	* AVL key type
50	*/
51	typedef void * AVLPVKEY;
52
53	/**
54	* AVL Core node.
55	*/
56	typedef struct _AVLPVNodeCore
57	{
58	AVLPVKEY Key; /** Key value. */
59	struct _AVLPVNodeCore pLeft; /* Pointer to left leaf node. */
60	struct _AVLPVNodeCore pRight; /* Pointer to right leaf node. */
61	unsigned char uchHeight; /** Height of this tree: max(height(left), height(right)) + 1 */
62	} AVLPVNODECORE, PAVLPVNODECORE, *PPAVLPVNODECORE;
63
64	/** A tree with void pointer keys. */
65	typedef PAVLPVNODECORE AVLPVTREE;
66	/** Pointer to a tree with void pointer keys. */
67	typedef PPAVLPVNODECORE PAVLPVTREE;
68
69	/** Callback function for AVLPVDoWithAll(). */
70	typedef DECLCALLBACK(int) AVLPVCALLBACK(PAVLPVNODECORE, void *);
71	/** Pointer to callback function for AVLPVDoWithAll(). */
72	typedef AVLPVCALLBACK *PAVLPVCALLBACK;
73
74	/*
75	* Functions.
76	*/
77	RTDECL(bool) RTAvlPVInsert(PAVLPVTREE ppTree, PAVLPVNODECORE pNode);
78	RTDECL(PAVLPVNODECORE) RTAvlPVRemove(PAVLPVTREE ppTree, AVLPVKEY Key);
79	RTDECL(PAVLPVNODECORE) RTAvlPVGet(PAVLPVTREE ppTree, AVLPVKEY Key);
80	RTDECL(PAVLPVNODECORE) RTAvlPVGetBestFit(PAVLPVTREE ppTree, AVLPVKEY Key, bool fAbove);
81	RTDECL(PAVLPVNODECORE) RTAvlPVRemoveBestFit(PAVLPVTREE ppTree, AVLPVKEY Key, bool fAbove);
82	RTDECL(int) RTAvlPVDoWithAll(PAVLPVTREE ppTree, int fFromLeft, PAVLPVCALLBACK pfnCallBack, void *pvParam);
83	RTDECL(int) RTAvlPVDestroy(PAVLPVTREE ppTree, PAVLPVCALLBACK pfnCallBack, void *pvParam);
84
85	/** @} */
86
87
88	/** AVL tree of unsigned long.
89	* @{
90	*/
91
92	/**
93	* AVL key type
94	*/
95	typedef unsigned long AVLULKEY;
96
97	/**
98	* AVL Core node.
99	*/
100	typedef struct _AVLULNodeCore
101	{
102	AVLULKEY Key; /** Key value. */
103	struct _AVLULNodeCore pLeft; /* Pointer to left leaf node. */
104	struct _AVLULNodeCore pRight; /* Pointer to right leaf node. */
105	unsigned char uchHeight; /** Height of this tree: max(height(left), height(right)) + 1 */
106	} AVLULNODECORE, PAVLULNODECORE, *PPAVLULNODECORE;
107
108
109	/** Callback function for AVLULDoWithAll(). */
110	typedef DECLCALLBACK(int) AVLULCALLBACK(PAVLULNODECORE, void*);
111	/** Pointer to callback function for AVLULDoWithAll(). */
112	typedef AVLULCALLBACK *PAVLULCALLBACK;
113
114
115	/*
116	* Functions.
117	*/
118	RTDECL(bool) RTAvlULInsert(PPAVLULNODECORE ppTree, PAVLULNODECORE pNode);
119	RTDECL(PAVLULNODECORE) RTAvlULRemove(PPAVLULNODECORE ppTree, AVLULKEY Key);
120	RTDECL(PAVLULNODECORE) RTAvlULGet(PPAVLULNODECORE ppTree, AVLULKEY Key);
121	RTDECL(PAVLULNODECORE) RTAvlULGetBestFit(PPAVLULNODECORE ppTree, AVLULKEY Key, bool fAbove);
122	RTDECL(PAVLULNODECORE) RTAvlULRemoveBestFit(PPAVLULNODECORE ppTree, AVLULKEY Key, bool fAbove);
123	RTDECL(int) RTAvlULDoWithAll(PPAVLULNODECORE ppTree, int fFromLeft, PAVLULCALLBACK pfnCallBack, void *pvParam);
124	RTDECL(int) RTAvlULDestroy(PPAVLULNODECORE pTree, PAVLULCALLBACK pfnCallBack, void *pvParam);
125
126	/** @} */
127
128
129
130	/** AVL tree of uint32_t
131	* @{
132	*/
133
134	/** AVL key type. */
135	typedef uint32_t AVLU32KEY;
136
137	/** AVL Core node. */
138	typedef struct _AVLU32NodeCore
139	{
140	AVLU32KEY Key; /*< Key value. /
141	struct _AVLU32NodeCore pLeft; /< Pointer to left leaf node. /
142	struct _AVLU32NodeCore pRight; /< Pointer to right leaf node. /
143	unsigned char uchHeight; /*< Height of this tree: max(height(left), height(right)) + 1 /
144	} AVLU32NODECORE, PAVLU32NODECORE, *PPAVLU32NODECORE;
145
146	/** Callback function for AVLU32DoWithAll() & AVLU32Destroy(). */
147	typedef DECLCALLBACK(int) AVLU32CALLBACK(PAVLU32NODECORE, void*);
148	/** Pointer to callback function for AVLU32DoWithAll() & AVLU32Destroy(). */
149	typedef AVLU32CALLBACK *PAVLU32CALLBACK;
150
151
152	/*
153	* Functions.
154	*/
155	RTDECL(bool) RTAvlU32Insert(PPAVLU32NODECORE ppTree, PAVLU32NODECORE pNode);
156	RTDECL(PAVLU32NODECORE) RTAvlU32Remove(PPAVLU32NODECORE ppTree, AVLU32KEY Key);
157	RTDECL(PAVLU32NODECORE) RTAvlU32Get(PPAVLU32NODECORE ppTree, AVLU32KEY Key);
158	RTDECL(PAVLU32NODECORE) RTAvlU32GetBestFit(PPAVLU32NODECORE ppTree, AVLU32KEY Key, bool fAbove);
159	RTDECL(PAVLU32NODECORE) RTAvlU32RemoveBestFit(PPAVLU32NODECORE ppTree, AVLU32KEY Key, bool fAbove);
160	RTDECL(int) RTAvlU32DoWithAll(PPAVLU32NODECORE ppTree, int fFromLeft, PAVLU32CALLBACK pfnCallBack, void *pvParam);
161	RTDECL(int) RTAvlU32Destroy(PPAVLU32NODECORE pTree, PAVLU32CALLBACK pfnCallBack, void *pvParam);
162
163	/** @} */
164
165	/**
166	* AVL uint32_t type for the relative offset pointer scheme.
167	*/
168	typedef int32_t AVLOU32;
169
170	typedef uint32_t AVLOU32KEY;
171
172	/**
173	* AVL Core node.
174	*/
175	typedef struct _AVLOU32NodeCore
176	{
177	/** Key value. */
178	AVLOU32KEY Key;
179	/** Offset to the left leaf node, relative to this field. */
180	AVLOU32 pLeft;
181	/** Offset to the right leaf node, relative to this field. */
182	AVLOU32 pRight;
183	/** Height of this tree: max(height(left), height(right)) + 1 */
184	unsigned char uchHeight;
185	} AVLOU32NODECORE, *PAVLOU32NODECORE;
186
187	/** A offset base tree with uint32_t keys. */
188	typedef AVLOU32 AVLOU32TREE;
189	/** Pointer to a offset base tree with uint32_t keys. */
190	typedef AVLOU32TREE *PAVLOU32TREE;
191
192	/** Pointer to an internal tree pointer.
193	* In this case it's a pointer to a relative offset. */
194	typedef AVLOU32TREE *PPAVLOU32NODECORE;
195
196	/** Callback function for RTAvloU32DoWithAll(). */
197	typedef DECLCALLBACK(int) AVLOU32CALLBACK(PAVLOU32NODECORE pNode, void *pvUser);
198	/** Pointer to callback function for RTAvloU32DoWithAll(). */
199	typedef AVLOU32CALLBACK *PAVLOU32CALLBACK;
200
201	RTDECL(bool) RTAvloU32Insert(PAVLOU32TREE pTree, PAVLOU32NODECORE pNode);
202	RTDECL(PAVLOU32NODECORE) RTAvloU32Remove(PAVLOU32TREE pTree, AVLOU32KEY Key);
203	RTDECL(PAVLOU32NODECORE) RTAvloU32Get(PAVLOU32TREE pTree, AVLOU32KEY Key);
204	RTDECL(int) RTAvloU32DoWithAll(PAVLOU32TREE pTree, int fFromLeft, PAVLOU32CALLBACK pfnCallBack, void *pvParam);
205	RTDECL(PAVLOU32NODECORE) RTAvloU32GetBestFit(PAVLOU32TREE ppTree, AVLOU32KEY Key, bool fAbove);
206	RTDECL(PAVLOU32NODECORE) RTAvloU32RemoveBestFit(PAVLOU32TREE ppTree, AVLOU32KEY Key, bool fAbove);
207	RTDECL(int) RTAvloU32Destroy(PAVLOU32TREE pTree, PAVLOU32CALLBACK pfnCallBack, void *pvParam);
208
209	/** @} */
210
211
212	/** AVL tree of uint32_t, list duplicates.
213	* @{
214	*/
215
216	/** AVL key type. */
217	typedef uint32_t AVLLU32KEY;
218
219	/** AVL Core node. */
220	typedef struct _AVLLU32NodeCore
221	{
222	AVLLU32KEY Key; /*< Key value. /
223	unsigned char uchHeight; /*< Height of this tree: max(height(left), height(right)) + 1 /
224	struct _AVLLU32NodeCore pLeft; /< Pointer to left leaf node. /
225	struct _AVLLU32NodeCore pRight; /< Pointer to right leaf node. /
226	struct _AVLLU32NodeCore pList; /< Pointer to next node with the same key. /
227	} AVLLU32NODECORE, PAVLLU32NODECORE, *PPAVLLU32NODECORE;
228
229	/** Callback function for RTAvllU32DoWithAll() & RTAvllU32Destroy(). */
230	typedef DECLCALLBACK(int) AVLLU32CALLBACK(PAVLLU32NODECORE, void*);
231	/** Pointer to callback function for RTAvllU32DoWithAll() & RTAvllU32Destroy(). */
232	typedef AVLLU32CALLBACK *PAVLLU32CALLBACK;
233
234
235	/*
236	* Functions.
237	*/
238	RTDECL(bool) RTAvllU32Insert(PPAVLLU32NODECORE ppTree, PAVLLU32NODECORE pNode);
239	RTDECL(PAVLLU32NODECORE) RTAvllU32Remove(PPAVLLU32NODECORE ppTree, AVLLU32KEY Key);
240	RTDECL(PAVLLU32NODECORE) RTAvllU32Get(PPAVLLU32NODECORE ppTree, AVLLU32KEY Key);
241	RTDECL(PAVLLU32NODECORE) RTAvllU32GetBestFit(PPAVLLU32NODECORE ppTree, AVLLU32KEY Key, bool fAbove);
242	RTDECL(PAVLLU32NODECORE) RTAvllU32RemoveBestFit(PPAVLLU32NODECORE ppTree, AVLLU32KEY Key, bool fAbove);
243	RTDECL(int) RTAvllU32DoWithAll(PPAVLLU32NODECORE ppTree, int fFromLeft, PAVLLU32CALLBACK pfnCallBack, void *pvParam);
244	RTDECL(int) RTAvllU32Destroy(PPAVLLU32NODECORE pTree, PAVLLU32CALLBACK pfnCallBack, void *pvParam);
245
246	/** @} */
247
248
249
250	/** AVL tree of RTGCPHYSes - using relative offsets internally.
251	* @{
252	*/
253
254	/**
255	* AVL 'pointer' type for the relative offset pointer scheme.
256	*/
257	typedef int32_t AVLOGCPHYS;
258
259	/**
260	* AVL Core node.
261	*/
262	typedef struct _AVLOGCPhysNodeCore
263	{
264	/** Key value. */
265	RTGCPHYS Key;
266	/** Offset to the left leaf node, relative to this field. */
267	AVLOGCPHYS pLeft;
268	/** Offset to the right leaf node, relative to this field. */
269	AVLOGCPHYS pRight;
270	/** Height of this tree: max(height(left), height(right)) + 1 */
271	unsigned char uchHeight;
272	/** Padding */
273	unsigned char Padding[7];
274	} AVLOGCPHYSNODECORE, *PAVLOGCPHYSNODECORE;
275
276	/** A offset base tree with uint32_t keys. */
277	typedef AVLOGCPHYS AVLOGCPHYSTREE;
278	/** Pointer to a offset base tree with uint32_t keys. */
279	typedef AVLOGCPHYSTREE *PAVLOGCPHYSTREE;
280
281	/** Pointer to an internal tree pointer.
282	* In this case it's a pointer to a relative offset. */
283	typedef AVLOGCPHYSTREE *PPAVLOGCPHYSNODECORE;
284
285	/** Callback function for RTAvloGCPhysDoWithAll() and RTAvloGCPhysDestroy(). */
286	typedef DECLCALLBACK(int) AVLOGCPHYSCALLBACK(PAVLOGCPHYSNODECORE pNode, void *pvUser);
287	/** Pointer to callback function for RTAvloGCPhysDoWithAll() and RTAvloGCPhysDestroy(). */
288	typedef AVLOGCPHYSCALLBACK *PAVLOGCPHYSCALLBACK;
289
290	RTDECL(bool) RTAvloGCPhysInsert(PAVLOGCPHYSTREE pTree, PAVLOGCPHYSNODECORE pNode);
291	RTDECL(PAVLOGCPHYSNODECORE) RTAvloGCPhysRemove(PAVLOGCPHYSTREE pTree, RTGCPHYS Key);
292	RTDECL(PAVLOGCPHYSNODECORE) RTAvloGCPhysGet(PAVLOGCPHYSTREE pTree, RTGCPHYS Key);
293	RTDECL(int) RTAvloGCPhysDoWithAll(PAVLOGCPHYSTREE pTree, int fFromLeft, PAVLOGCPHYSCALLBACK pfnCallBack, void *pvParam);
294	RTDECL(PAVLOGCPHYSNODECORE) RTAvloGCPhysGetBestFit(PAVLOGCPHYSTREE ppTree, RTGCPHYS Key, bool fAbove);
295	RTDECL(PAVLOGCPHYSNODECORE) RTAvloGCPhysRemoveBestFit(PAVLOGCPHYSTREE ppTree, RTGCPHYS Key, bool fAbove);
296	RTDECL(int) RTAvloGCPhysDestroy(PAVLOGCPHYSTREE pTree, PAVLOGCPHYSCALLBACK pfnCallBack, void *pvParam);
297
298	/** @} */
299
300
301	/** AVL tree of RTGCPHYS ranges - using relative offsets internally.
302	* @{
303	*/
304
305	/**
306	* AVL 'pointer' type for the relative offset pointer scheme.
307	*/
308	typedef int32_t AVLROGCPHYS;
309
310	/**
311	* AVL Core node.
312	*/
313	typedef struct _AVLROGCPhysNodeCore
314	{
315	/** First key value in the range (inclusive). */
316	RTGCPHYS Key;
317	/** Last key value in the range (inclusive). */
318	RTGCPHYS KeyLast;
319	/** Offset to the left leaf node, relative to this field. */
320	AVLROGCPHYS pLeft;
321	/** Offset to the right leaf node, relative to this field. */
322	AVLROGCPHYS pRight;
323	/** Height of this tree: max(height(left), height(right)) + 1 */
324	unsigned char uchHeight;
325	/** Padding */
326	unsigned char Padding[7];
327	} AVLROGCPHYSNODECORE, *PAVLROGCPHYSNODECORE;
328
329	/** A offset base tree with uint32_t keys. */
330	typedef AVLROGCPHYS AVLROGCPHYSTREE;
331	/** Pointer to a offset base tree with uint32_t keys. */
332	typedef AVLROGCPHYSTREE *PAVLROGCPHYSTREE;
333
334	/** Pointer to an internal tree pointer.
335	* In this case it's a pointer to a relative offset. */
336	typedef AVLROGCPHYSTREE *PPAVLROGCPHYSNODECORE;
337
338	/** Callback function for RTAvlroGCPhysDoWithAll() and RTAvlroGCPhysDestroy(). */
339	typedef DECLCALLBACK(int) AVLROGCPHYSCALLBACK(PAVLROGCPHYSNODECORE pNode, void *pvUser);
340	/** Pointer to callback function for RTAvlroGCPhysDoWithAll() and RTAvlroGCPhysDestroy(). */
341	typedef AVLROGCPHYSCALLBACK *PAVLROGCPHYSCALLBACK;
342
343	RTDECL(bool) RTAvlroGCPhysInsert(PAVLROGCPHYSTREE pTree, PAVLROGCPHYSNODECORE pNode);
344	RTDECL(PAVLROGCPHYSNODECORE) RTAvlroGCPhysRemove(PAVLROGCPHYSTREE pTree, RTGCPHYS Key);
345	RTDECL(PAVLROGCPHYSNODECORE) RTAvlroGCPhysGet(PAVLROGCPHYSTREE pTree, RTGCPHYS Key);
346	RTDECL(PAVLROGCPHYSNODECORE) RTAvlroGCPhysRangeGet(PAVLROGCPHYSTREE pTree, RTGCPHYS Key);
347	RTDECL(PAVLROGCPHYSNODECORE) RTAvlroGCPhysRangeRemove(PAVLROGCPHYSTREE pTree, RTGCPHYS Key);
348	RTDECL(PAVLROGCPHYSNODECORE) RTAvlroGCPhysGetBestFit(PAVLROGCPHYSTREE ppTree, RTGCPHYS Key, bool fAbove);
349	RTDECL(int) RTAvlroGCPhysDoWithAll(PAVLROGCPHYSTREE pTree, int fFromLeft, PAVLROGCPHYSCALLBACK pfnCallBack, void *pvParam);
350	RTDECL(int) RTAvlroGCPhysDestroy(PAVLROGCPHYSTREE pTree, PAVLROGCPHYSCALLBACK pfnCallBack, void *pvParam);
351	RTDECL(PAVLROGCPHYSNODECORE) RTAvlroGCPhysGetRoot(PAVLROGCPHYSTREE pTree);
352	RTDECL(PAVLROGCPHYSNODECORE) RTAvlroGCPhysGetLeft(PAVLROGCPHYSNODECORE pNode);
353	RTDECL(PAVLROGCPHYSNODECORE) RTAvlroGCPhysGetRight(PAVLROGCPHYSNODECORE pNode);
354
355	/** @} */
356
357
358	/** AVL tree of RTGCPTRs.
359	* @{
360	*/
361
362	/**
363	* AVL Core node.
364	*/
365	typedef struct _AVLGCPtrNodeCore
366	{
367	/** Key value. */
368	RTGCPTR Key;
369	/** Pointer to the left node. */
370	struct _AVLGCPtrNodeCore *pLeft;
371	/** Pointer to the right node. */
372	struct _AVLGCPtrNodeCore *pRight;
373	/** Height of this tree: max(height(left), height(right)) + 1 */
374	unsigned char uchHeight;
375	} AVLGCPTRNODECORE, PAVLGCPTRNODECORE, *PPAVLGCPTRNODECORE;
376
377	/** A tree of RTGCPTR keys. */
378	typedef PAVLGCPTRNODECORE AVLGCPTRTREE;
379	/** Pointer to a tree of RTGCPTR keys. */
380	typedef PPAVLGCPTRNODECORE PAVLGCPTRTREE;
381
382	/** Callback function for RTAvlGCPtrDoWithAll(). */
383	typedef DECLCALLBACK(int) AVLGCPTRCALLBACK(PAVLGCPTRNODECORE pNode, void *pvUser);
384	/** Pointer to callback function for RTAvlGCPtrDoWithAll(). */
385	typedef AVLGCPTRCALLBACK *PAVLGCPTRCALLBACK;
386
387	RTDECL(bool) RTAvlGCPtrInsert(PAVLGCPTRTREE pTree, PAVLGCPTRNODECORE pNode);
388	RTDECL(PAVLGCPTRNODECORE) RTAvlGCPtrRemove(PAVLGCPTRTREE pTree, RTGCPTR Key);
389	RTDECL(PAVLGCPTRNODECORE) RTAvlGCPtrGet(PAVLGCPTRTREE pTree, RTGCPTR Key);
390	RTDECL(int) RTAvlGCPtrDoWithAll(PAVLGCPTRTREE pTree, int fFromLeft, PAVLGCPTRCALLBACK pfnCallBack, void *pvParam);
391	RTDECL(PAVLGCPTRNODECORE) RTAvlGCPtrGetBestFit(PAVLGCPTRTREE ppTree, RTGCPTR Key, bool fAbove);
392	RTDECL(PAVLGCPTRNODECORE) RTAvlGCPtrRemoveBestFit(PAVLGCPTRTREE ppTree, RTGCPTR Key, bool fAbove);
393	RTDECL(int) RTAvlGCPtrDestroy(PAVLGCPTRTREE pTree, PAVLGCPTRCALLBACK pfnCallBack, void *pvParam);
394
395	/** @} */
396
397
398	/** AVL tree of RTGCPTRs - using relative offsets internally.
399	* @{
400	*/
401
402	/**
403	* AVL 'pointer' type for the relative offset pointer scheme.
404	*/
405	typedef int32_t AVLOGCPTR;
406
407	/**
408	* AVL Core node.
409	*/
410	typedef struct _AVLOGCPtrNodeCore
411	{
412	/** Key value. */
413	RTGCPTR Key;
414	/** Offset to the left leaf node, relative to this field. */
415	AVLOGCPTR pLeft;
416	/** Offset to the right leaf node, relative to this field. */
417	AVLOGCPTR pRight;
418	/** Height of this tree: max(height(left), height(right)) + 1 */
419	unsigned char uchHeight;
420	unsigned char padding[GC_ARCH_BITS == 64 ? 7 : 3];
421	} AVLOGCPTRNODECORE, *PAVLOGCPTRNODECORE;
422
423	/** A offset base tree with uint32_t keys. */
424	typedef AVLOGCPTR AVLOGCPTRTREE;
425	/** Pointer to a offset base tree with uint32_t keys. */
426	typedef AVLOGCPTRTREE *PAVLOGCPTRTREE;
427
428	/** Pointer to an internal tree pointer.
429	* In this case it's a pointer to a relative offset. */
430	typedef AVLOGCPTRTREE *PPAVLOGCPTRNODECORE;
431
432	/** Callback function for RTAvloGCPtrDoWithAll(). */
433	typedef DECLCALLBACK(int) AVLOGCPTRCALLBACK(PAVLOGCPTRNODECORE pNode, void *pvUser);
434	/** Pointer to callback function for RTAvloGCPtrDoWithAll(). */
435	typedef AVLOGCPTRCALLBACK *PAVLOGCPTRCALLBACK;
436
437	RTDECL(bool) RTAvloGCPtrInsert(PAVLOGCPTRTREE pTree, PAVLOGCPTRNODECORE pNode);
438	RTDECL(PAVLOGCPTRNODECORE) RTAvloGCPtrRemove(PAVLOGCPTRTREE pTree, RTGCPTR Key);
439	RTDECL(PAVLOGCPTRNODECORE) RTAvloGCPtrGet(PAVLOGCPTRTREE pTree, RTGCPTR Key);
440	RTDECL(int) RTAvloGCPtrDoWithAll(PAVLOGCPTRTREE pTree, int fFromLeft, PAVLOGCPTRCALLBACK pfnCallBack, void *pvParam);
441	RTDECL(PAVLOGCPTRNODECORE) RTAvloGCPtrGetBestFit(PAVLOGCPTRTREE ppTree, RTGCPTR Key, bool fAbove);
442	RTDECL(PAVLOGCPTRNODECORE) RTAvloGCPtrRemoveBestFit(PAVLOGCPTRTREE ppTree, RTGCPTR Key, bool fAbove);
443	RTDECL(int) RTAvloGCPtrDestroy(PAVLOGCPTRTREE pTree, PAVLOGCPTRCALLBACK pfnCallBack, void *pvParam);
444
445	/** @} */
446
447
448	/** AVL tree of RTGCPTR ranges.
449	* @{
450	*/
451
452	/**
453	* AVL Core node.
454	*/
455	typedef struct _AVLRGCPtrNodeCore
456	{
457	/** First key value in the range (inclusive). */
458	RTGCPTR Key;
459	/** Last key value in the range (inclusive). */
460	RTGCPTR KeyLast;
461	/** Offset to the left leaf node, relative to this field. */
462	struct _AVLRGCPtrNodeCore *pLeft;
463	/** Offset to the right leaf node, relative to this field. */
464	struct _AVLRGCPtrNodeCore *pRight;
465	/** Height of this tree: max(height(left), height(right)) + 1 */
466	unsigned char uchHeight;
467	} AVLRGCPTRNODECORE, *PAVLRGCPTRNODECORE;
468
469	/** A offset base tree with RTGCPTR keys. */
470	typedef PAVLRGCPTRNODECORE AVLRGCPTRTREE;
471	/** Pointer to a offset base tree with RTGCPTR keys. */
472	typedef AVLRGCPTRTREE *PAVLRGCPTRTREE;
473
474	/** Pointer to an internal tree pointer.
475	* In this case it's a pointer to a relative offset. */
476	typedef AVLRGCPTRTREE *PPAVLRGCPTRNODECORE;
477
478	/** Callback function for RTAvlrGCPtrDoWithAll() and RTAvlrGCPtrDestroy(). */
479	typedef DECLCALLBACK(int) AVLRGCPTRCALLBACK(PAVLRGCPTRNODECORE pNode, void *pvUser);
480	/** Pointer to callback function for RTAvlrGCPtrDoWithAll() and RTAvlrGCPtrDestroy(). */
481	typedef AVLRGCPTRCALLBACK *PAVLRGCPTRCALLBACK;
482
483	RTDECL(bool) RTAvlrGCPtrInsert( PAVLRGCPTRTREE pTree, PAVLRGCPTRNODECORE pNode);
484	RTDECL(PAVLRGCPTRNODECORE) RTAvlrGCPtrRemove( PAVLRGCPTRTREE pTree, RTGCPTR Key);
485	RTDECL(PAVLRGCPTRNODECORE) RTAvlrGCPtrGet( PAVLRGCPTRTREE pTree, RTGCPTR Key);
486	RTDECL(PAVLRGCPTRNODECORE) RTAvlrGCPtrGetBestFit( PAVLRGCPTRTREE pTree, RTGCPTR Key, bool fAbove);
487	RTDECL(PAVLRGCPTRNODECORE) RTAvlrGCPtrRangeGet( PAVLRGCPTRTREE pTree, RTGCPTR Key);
488	RTDECL(PAVLRGCPTRNODECORE) RTAvlrGCPtrRangeRemove( PAVLRGCPTRTREE pTree, RTGCPTR Key);
489	RTDECL(int) RTAvlrGCPtrDoWithAll( PAVLRGCPTRTREE pTree, int fFromLeft, PAVLRGCPTRCALLBACK pfnCallBack, void *pvParam);
490	RTDECL(int) RTAvlrGCPtrDestroy( PAVLRGCPTRTREE pTree, PAVLRGCPTRCALLBACK pfnCallBack, void *pvParam);
491	RTDECL(PAVLRGCPTRNODECORE) RTAvlrGCPtrGetRoot( PAVLRGCPTRTREE pTree);
492	RTDECL(PAVLRGCPTRNODECORE) RTAvlrGCPtrGetLeft( PAVLRGCPTRNODECORE pNode);
493	RTDECL(PAVLRGCPTRNODECORE) RTAvlrGCPtrGetRight( PAVLRGCPTRNODECORE pNode);
494
495	/** @} */
496
497
498	/** AVL tree of RTGCPTR ranges - using relative offsets internally.
499	* @{
500	*/
501
502	/**
503	* AVL 'pointer' type for the relative offset pointer scheme.
504	*/
505	typedef int32_t AVLROGCPTR;
506
507	/**
508	* AVL Core node.
509	*/
510	typedef struct _AVLROGCPtrNodeCore
511	{
512	/** First key value in the range (inclusive). */
513	RTGCPTR Key;
514	/** Last key value in the range (inclusive). */
515	RTGCPTR KeyLast;
516	/** Offset to the left leaf node, relative to this field. */
517	AVLROGCPTR pLeft;
518	/** Offset to the right leaf node, relative to this field. */
519	AVLROGCPTR pRight;
520	/** Height of this tree: max(height(left), height(right)) + 1 */
521	unsigned char uchHeight;
522	unsigned char padding[GC_ARCH_BITS == 64 ? 7 : 7];
523	} AVLROGCPTRNODECORE, *PAVLROGCPTRNODECORE;
524
525	/** A offset base tree with uint32_t keys. */
526	typedef AVLROGCPTR AVLROGCPTRTREE;
527	/** Pointer to a offset base tree with uint32_t keys. */
528	typedef AVLROGCPTRTREE *PAVLROGCPTRTREE;
529
530	/** Pointer to an internal tree pointer.
531	* In this case it's a pointer to a relative offset. */
532	typedef AVLROGCPTRTREE *PPAVLROGCPTRNODECORE;
533
534	/** Callback function for RTAvlroGCPtrDoWithAll() and RTAvlroGCPtrDestroy(). */
535	typedef DECLCALLBACK(int) AVLROGCPTRCALLBACK(PAVLROGCPTRNODECORE pNode, void *pvUser);
536	/** Pointer to callback function for RTAvlroGCPtrDoWithAll() and RTAvlroGCPtrDestroy(). */
537	typedef AVLROGCPTRCALLBACK *PAVLROGCPTRCALLBACK;
538
539	RTDECL(bool) RTAvlroGCPtrInsert(PAVLROGCPTRTREE pTree, PAVLROGCPTRNODECORE pNode);
540	RTDECL(PAVLROGCPTRNODECORE) RTAvlroGCPtrRemove(PAVLROGCPTRTREE pTree, RTGCPTR Key);
541	RTDECL(PAVLROGCPTRNODECORE) RTAvlroGCPtrGet(PAVLROGCPTRTREE pTree, RTGCPTR Key);
542	RTDECL(PAVLROGCPTRNODECORE) RTAvlroGCPtrGetBestFit(PAVLROGCPTRTREE ppTree, RTGCPTR Key, bool fAbove);
543	RTDECL(PAVLROGCPTRNODECORE) RTAvlroGCPtrRangeGet(PAVLROGCPTRTREE pTree, RTGCPTR Key);
544	RTDECL(PAVLROGCPTRNODECORE) RTAvlroGCPtrRangeRemove(PAVLROGCPTRTREE pTree, RTGCPTR Key);
545	RTDECL(int) RTAvlroGCPtrDoWithAll(PAVLROGCPTRTREE pTree, int fFromLeft, PAVLROGCPTRCALLBACK pfnCallBack, void *pvParam);
546	RTDECL(int) RTAvlroGCPtrDestroy(PAVLROGCPTRTREE pTree, PAVLROGCPTRCALLBACK pfnCallBack, void *pvParam);
547	RTDECL(PAVLROGCPTRNODECORE) RTAvlroGCPtrGetRoot(PAVLROGCPTRTREE pTree);
548	RTDECL(PAVLROGCPTRNODECORE) RTAvlroGCPtrGetLeft(PAVLROGCPTRNODECORE pNode);
549	RTDECL(PAVLROGCPTRNODECORE) RTAvlroGCPtrGetRight(PAVLROGCPTRNODECORE pNode);
550
551	/** @} */
552
553
554	/** AVL tree of RTGCPTR ranges (overlapping supported) - using relative offsets internally.
555	* @{
556	*/
557
558	/**
559	* AVL 'pointer' type for the relative offset pointer scheme.
560	*/
561	typedef int32_t AVLROOGCPTR;
562
563	/**
564	* AVL Core node.
565	*/
566	typedef struct _AVLROOGCPtrNodeCore
567	{
568	/** First key value in the range (inclusive). */
569	RTGCPTR Key;
570	/** Last key value in the range (inclusive). */
571	RTGCPTR KeyLast;
572	/** Offset to the left leaf node, relative to this field. */
573	AVLROOGCPTR pLeft;
574	/** Offset to the right leaf node, relative to this field. */
575	AVLROOGCPTR pRight;
576	/** Pointer to the list of string with the same key. Don't touch. */
577	AVLROOGCPTR pList;
578	/** Height of this tree: max(height(left), height(right)) + 1 */
579	unsigned char uchHeight;
580	} AVLROOGCPTRNODECORE, *PAVLROOGCPTRNODECORE;
581
582	/** A offset base tree with uint32_t keys. */
583	typedef AVLROOGCPTR AVLROOGCPTRTREE;
584	/** Pointer to a offset base tree with uint32_t keys. */
585	typedef AVLROOGCPTRTREE *PAVLROOGCPTRTREE;
586
587	/** Pointer to an internal tree pointer.
588	* In this case it's a pointer to a relative offset. */
589	typedef AVLROOGCPTRTREE *PPAVLROOGCPTRNODECORE;
590
591	/** Callback function for RTAvlrooGCPtrDoWithAll() and RTAvlrooGCPtrDestroy(). */
592	typedef DECLCALLBACK(int) AVLROOGCPTRCALLBACK(PAVLROOGCPTRNODECORE pNode, void *pvUser);
593	/** Pointer to callback function for RTAvlrooGCPtrDoWithAll() and RTAvlrooGCPtrDestroy(). */
594	typedef AVLROOGCPTRCALLBACK *PAVLROOGCPTRCALLBACK;
595
596	RTDECL(bool) RTAvlrooGCPtrInsert(PAVLROOGCPTRTREE pTree, PAVLROOGCPTRNODECORE pNode);
597	RTDECL(PAVLROOGCPTRNODECORE) RTAvlrooGCPtrRemove(PAVLROOGCPTRTREE pTree, RTGCPTR Key);
598	RTDECL(PAVLROOGCPTRNODECORE) RTAvlrooGCPtrGet(PAVLROOGCPTRTREE pTree, RTGCPTR Key);
599	RTDECL(PAVLROOGCPTRNODECORE) RTAvlrooGCPtrGetBestFit(PAVLROOGCPTRTREE ppTree, RTGCPTR Key, bool fAbove);
600	RTDECL(PAVLROOGCPTRNODECORE) RTAvlrooGCPtrRangeGet(PAVLROOGCPTRTREE pTree, RTGCPTR Key);
601	RTDECL(PAVLROOGCPTRNODECORE) RTAvlrooGCPtrRangeRemove(PAVLROOGCPTRTREE pTree, RTGCPTR Key);
602	RTDECL(int) RTAvlrooGCPtrDoWithAll(PAVLROOGCPTRTREE pTree, int fFromLeft, PAVLROOGCPTRCALLBACK pfnCallBack, void *pvParam);
603	RTDECL(int) RTAvlrooGCPtrDestroy(PAVLROOGCPTRTREE pTree, PAVLROOGCPTRCALLBACK pfnCallBack, void *pvParam);
604	RTDECL(PAVLROOGCPTRNODECORE) RTAvlrooGCPtrGetRoot(PAVLROOGCPTRTREE pTree);
605	RTDECL(PAVLROOGCPTRNODECORE) RTAvlrooGCPtrGetLeft(PAVLROOGCPTRNODECORE pNode);
606	RTDECL(PAVLROOGCPTRNODECORE) RTAvlrooGCPtrGetRight(PAVLROOGCPTRNODECORE pNode);
607	RTDECL(PAVLROOGCPTRNODECORE) RTAvlrooGCPtrGetNextEqual(PAVLROOGCPTRNODECORE pNode);
608
609	/** @} */
610
611
612	/** AVL tree of RTUINTPTR ranges.
613	* @{
614	*/
615
616	/**
617	* AVL Core node.
618	*/
619	typedef struct _AVLRUIntPtrNodeCore
620	{
621	/** First key value in the range (inclusive). */
622	RTUINTPTR Key;
623	/** Last key value in the range (inclusive). */
624	RTUINTPTR KeyLast;
625	/** Offset to the left leaf node, relative to this field. */
626	struct _AVLRUIntPtrNodeCore *pLeft;
627	/** Offset to the right leaf node, relative to this field. */
628	struct _AVLRUIntPtrNodeCore *pRight;
629	/** Height of this tree: max(height(left), height(right)) + 1 */
630	unsigned char uchHeight;
631	} AVLRUINTPTRNODECORE, *PAVLRUINTPTRNODECORE;
632
633	/** A offset base tree with RTUINTPTR keys. */
634	typedef PAVLRUINTPTRNODECORE AVLRUINTPTRTREE;
635	/** Pointer to a offset base tree with RTUINTPTR keys. */
636	typedef AVLRUINTPTRTREE *PAVLRUINTPTRTREE;
637
638	/** Pointer to an internal tree pointer.
639	* In this case it's a pointer to a relative offset. */
640	typedef AVLRUINTPTRTREE *PPAVLRUINTPTRNODECORE;
641
642	/** Callback function for RTAvlrUIntPtrDoWithAll() and RTAvlrUIntPtrDestroy(). */
643	typedef DECLCALLBACK(int) AVLRUINTPTRCALLBACK(PAVLRUINTPTRNODECORE pNode, void *pvUser);
644	/** Pointer to callback function for RTAvlrUIntPtrDoWithAll() and RTAvlrUIntPtrDestroy(). */
645	typedef AVLRUINTPTRCALLBACK *PAVLRUINTPTRCALLBACK;
646
647	RTDECL(bool) RTAvlrUIntPtrInsert( PAVLRUINTPTRTREE pTree, PAVLRUINTPTRNODECORE pNode);
648	RTDECL(PAVLRUINTPTRNODECORE) RTAvlrUIntPtrRemove( PAVLRUINTPTRTREE pTree, RTUINTPTR Key);
649	RTDECL(PAVLRUINTPTRNODECORE) RTAvlrUIntPtrGet( PAVLRUINTPTRTREE pTree, RTUINTPTR Key);
650	RTDECL(PAVLRUINTPTRNODECORE) RTAvlrUIntPtrGetBestFit( PAVLRUINTPTRTREE pTree, RTUINTPTR Key, bool fAbove);
651	RTDECL(PAVLRUINTPTRNODECORE) RTAvlrUIntPtrRangeGet( PAVLRUINTPTRTREE pTree, RTUINTPTR Key);
652	RTDECL(PAVLRUINTPTRNODECORE) RTAvlrUIntPtrRangeRemove(PAVLRUINTPTRTREE pTree, RTUINTPTR Key);
653	RTDECL(int) RTAvlrUIntPtrDoWithAll( PAVLRUINTPTRTREE pTree, int fFromLeft, PAVLRUINTPTRCALLBACK pfnCallBack, void *pvParam);
654	RTDECL(int) RTAvlrUIntPtrDestroy( PAVLRUINTPTRTREE pTree, PAVLRUINTPTRCALLBACK pfnCallBack, void *pvParam);
655	RTDECL(PAVLRUINTPTRNODECORE) RTAvlrUIntPtrGetRoot( PAVLRUINTPTRTREE pTree);
656	RTDECL(PAVLRUINTPTRNODECORE) RTAvlrUIntPtrGetLeft( PAVLRUINTPTRNODECORE pNode);
657	RTDECL(PAVLRUINTPTRNODECORE) RTAvlrUIntPtrGetRight( PAVLRUINTPTRNODECORE pNode);
658
659	/** @} */
660
661
662	/** AVL tree of RTHCPHYSes - using relative offsets internally.
663	* @{
664	*/
665
666	/**
667	* AVL 'pointer' type for the relative offset pointer scheme.
668	*/
669	typedef int32_t AVLOHCPHYS;
670
671	/**
672	* AVL Core node.
673	*/
674	typedef struct _AVLOHCPhysNodeCore
675	{
676	/** Key value. */
677	RTHCPHYS Key;
678	/** Offset to the left leaf node, relative to this field. */
679	AVLOHCPHYS pLeft;
680	/** Offset to the right leaf node, relative to this field. */
681	AVLOHCPHYS pRight;
682	/** Height of this tree: max(height(left), height(right)) + 1 */
683	unsigned char uchHeight;
684	#if HC_ARCH_BITS == 64 \|\| GC_ARCH_BITS == 64
685	unsigned char Padding[7]; /*< Alignment padding. /
686	#endif
687	} AVLOHCPHYSNODECORE, *PAVLOHCPHYSNODECORE;
688
689	/** A offset base tree with uint32_t keys. */
690	typedef AVLOHCPHYS AVLOHCPHYSTREE;
691	/** Pointer to a offset base tree with uint32_t keys. */
692	typedef AVLOHCPHYSTREE *PAVLOHCPHYSTREE;
693
694	/** Pointer to an internal tree pointer.
695	* In this case it's a pointer to a relative offset. */
696	typedef AVLOHCPHYSTREE *PPAVLOHCPHYSNODECORE;
697
698	/** Callback function for RTAvloHCPhysDoWithAll() and RTAvloHCPhysDestroy(). */
699	typedef DECLCALLBACK(int) AVLOHCPHYSCALLBACK(PAVLOHCPHYSNODECORE pNode, void *pvUser);
700	/** Pointer to callback function for RTAvloHCPhysDoWithAll() and RTAvloHCPhysDestroy(). */
701	typedef AVLOHCPHYSCALLBACK *PAVLOHCPHYSCALLBACK;
702
703	RTDECL(bool) RTAvloHCPhysInsert(PAVLOHCPHYSTREE pTree, PAVLOHCPHYSNODECORE pNode);
704	RTDECL(PAVLOHCPHYSNODECORE) RTAvloHCPhysRemove(PAVLOHCPHYSTREE pTree, RTHCPHYS Key);
705	RTDECL(PAVLOHCPHYSNODECORE) RTAvloHCPhysGet(PAVLOHCPHYSTREE pTree, RTHCPHYS Key);
706	RTDECL(int) RTAvloHCPhysDoWithAll(PAVLOHCPHYSTREE pTree, int fFromLeft, PAVLOHCPHYSCALLBACK pfnCallBack, void *pvParam);
707	RTDECL(PAVLOHCPHYSNODECORE) RTAvloHCPhysGetBestFit(PAVLOHCPHYSTREE ppTree, RTHCPHYS Key, bool fAbove);
708	RTDECL(PAVLOHCPHYSNODECORE) RTAvloHCPhysRemoveBestFit(PAVLOHCPHYSTREE ppTree, RTHCPHYS Key, bool fAbove);
709	RTDECL(int) RTAvloHCPhysDestroy(PAVLOHCPHYSTREE pTree, PAVLOHCPHYSCALLBACK pfnCallBack, void *pvParam);
710
711	/** @} */
712
713
714
715	/** AVL tree of RTIOPORTs - using relative offsets internally.
716	* @{
717	*/
718
719	/**
720	* AVL 'pointer' type for the relative offset pointer scheme.
721	*/
722	typedef int32_t AVLOIOPORTPTR;
723
724	/**
725	* AVL Core node.
726	*/
727	typedef struct _AVLOIOPortNodeCore
728	{
729	/** Offset to the left leaf node, relative to this field. */
730	AVLOIOPORTPTR pLeft;
731	/** Offset to the right leaf node, relative to this field. */
732	AVLOIOPORTPTR pRight;
733	/** Key value. */
734	RTIOPORT Key;
735	/** Height of this tree: max(height(left), height(right)) + 1 */
736	unsigned char uchHeight;
737	} AVLOIOPORTNODECORE, *PAVLOIOPORTNODECORE;
738
739	/** A offset base tree with uint32_t keys. */
740	typedef AVLOIOPORTPTR AVLOIOPORTTREE;
741	/** Pointer to a offset base tree with uint32_t keys. */
742	typedef AVLOIOPORTTREE *PAVLOIOPORTTREE;
743
744	/** Pointer to an internal tree pointer.
745	* In this case it's a pointer to a relative offset. */
746	typedef AVLOIOPORTTREE *PPAVLOIOPORTNODECORE;
747
748	/** Callback function for RTAvloIOPortDoWithAll() and RTAvloIOPortDestroy(). */
749	typedef DECLCALLBACK(int) AVLOIOPORTCALLBACK(PAVLOIOPORTNODECORE pNode, void *pvUser);
750	/** Pointer to callback function for RTAvloIOPortDoWithAll() and RTAvloIOPortDestroy(). */
751	typedef AVLOIOPORTCALLBACK *PAVLOIOPORTCALLBACK;
752
753	RTDECL(bool) RTAvloIOPortInsert(PAVLOIOPORTTREE pTree, PAVLOIOPORTNODECORE pNode);
754	RTDECL(PAVLOIOPORTNODECORE) RTAvloIOPortRemove(PAVLOIOPORTTREE pTree, RTIOPORT Key);
755	RTDECL(PAVLOIOPORTNODECORE) RTAvloIOPortGet(PAVLOIOPORTTREE pTree, RTIOPORT Key);
756	RTDECL(int) RTAvloIOPortDoWithAll(PAVLOIOPORTTREE pTree, int fFromLeft, PAVLOIOPORTCALLBACK pfnCallBack, void *pvParam);
757	RTDECL(PAVLOIOPORTNODECORE) RTAvloIOPortGetBestFit(PAVLOIOPORTTREE ppTree, RTIOPORT Key, bool fAbove);
758	RTDECL(PAVLOIOPORTNODECORE) RTAvloIOPortRemoveBestFit(PAVLOIOPORTTREE ppTree, RTIOPORT Key, bool fAbove);
759	RTDECL(int) RTAvloIOPortDestroy(PAVLOIOPORTTREE pTree, PAVLOIOPORTCALLBACK pfnCallBack, void *pvParam);
760	/** @} */
761
762
763	/** AVL tree of RTIOPORT ranges - using relative offsets internally.
764	* @{
765	*/
766
767	/**
768	* AVL 'pointer' type for the relative offset pointer scheme.
769	*/
770	typedef int32_t AVLROIOPORTPTR;
771
772	/**
773	* AVL Core node.
774	*/
775	typedef struct _AVLROIOPortNodeCore
776	{
777	/** First key value in the range (inclusive). */
778	RTIOPORT Key;
779	/** Last key value in the range (inclusive). */
780	RTIOPORT KeyLast;
781	/** Offset to the left leaf node, relative to this field. */
782	AVLROIOPORTPTR pLeft;
783	/** Offset to the right leaf node, relative to this field. */
784	AVLROIOPORTPTR pRight;
785	/** Height of this tree: max(height(left), height(right)) + 1 */
786	unsigned char uchHeight;
787	} AVLROIOPORTNODECORE, *PAVLROIOPORTNODECORE;
788
789	/** A offset base tree with uint32_t keys. */
790	typedef AVLROIOPORTPTR AVLROIOPORTTREE;
791	/** Pointer to a offset base tree with uint32_t keys. */
792	typedef AVLROIOPORTTREE *PAVLROIOPORTTREE;
793
794	/** Pointer to an internal tree pointer.
795	* In this case it's a pointer to a relative offset. */
796	typedef AVLROIOPORTTREE *PPAVLROIOPORTNODECORE;
797
798	/** Callback function for RTAvlroIOPortDoWithAll() and RTAvlroIOPortDestroy(). */
799	typedef DECLCALLBACK(int) AVLROIOPORTCALLBACK(PAVLROIOPORTNODECORE pNode, void *pvUser);
800	/** Pointer to callback function for RTAvlroIOPortDoWithAll() and RTAvlroIOPortDestroy(). */
801	typedef AVLROIOPORTCALLBACK *PAVLROIOPORTCALLBACK;
802
803	RTDECL(bool) RTAvlroIOPortInsert(PAVLROIOPORTTREE pTree, PAVLROIOPORTNODECORE pNode);
804	RTDECL(PAVLROIOPORTNODECORE) RTAvlroIOPortRemove(PAVLROIOPORTTREE pTree, RTIOPORT Key);
805	RTDECL(PAVLROIOPORTNODECORE) RTAvlroIOPortGet(PAVLROIOPORTTREE pTree, RTIOPORT Key);
806	RTDECL(PAVLROIOPORTNODECORE) RTAvlroIOPortRangeGet(PAVLROIOPORTTREE pTree, RTIOPORT Key);
807	RTDECL(PAVLROIOPORTNODECORE) RTAvlroIOPortRangeRemove(PAVLROIOPORTTREE pTree, RTIOPORT Key);
808	RTDECL(int) RTAvlroIOPortDoWithAll(PAVLROIOPORTTREE pTree, int fFromLeft, PAVLROIOPORTCALLBACK pfnCallBack, void *pvParam);
809	RTDECL(int) RTAvlroIOPortDestroy(PAVLROIOPORTTREE pTree, PAVLROIOPORTCALLBACK pfnCallBack, void *pvParam);
810
811	/** @} */
812
813
814	/** AVL tree of RTHCPHYSes.
815	* @{
816	*/
817
818	/**
819	* AVL 'pointer' type for the relative offset pointer scheme.
820	*/
821	typedef struct _AVLHCPhysNodeCore *AVLHCPHYSPTR;
822
823	/**
824	* AVL Core node.
825	*/
826	typedef struct _AVLHCPhysNodeCore
827	{
828	/** Offset to the left leaf node, relative to this field. */
829	AVLHCPHYSPTR pLeft;
830	/** Offset to the right leaf node, relative to this field. */
831	AVLHCPHYSPTR pRight;
832	/** Key value. */
833	RTHCPHYS Key;
834	/** Height of this tree: max(height(left), height(right)) + 1 */
835	unsigned char uchHeight;
836	} AVLHCPHYSNODECORE, *PAVLHCPHYSNODECORE;
837
838	/** A offset base tree with RTHCPHYS keys. */
839	typedef AVLHCPHYSPTR AVLHCPHYSTREE;
840	/** Pointer to a offset base tree with RTHCPHYS keys. */
841	typedef AVLHCPHYSTREE *PAVLHCPHYSTREE;
842
843	/** Pointer to an internal tree pointer.
844	* In this case it's a pointer to a relative offset. */
845	typedef AVLHCPHYSTREE *PPAVLHCPHYSNODECORE;
846
847	/** Callback function for RTAvlHCPhysDoWithAll() and RTAvlHCPhysDestroy(). */
848	typedef DECLCALLBACK(int) AVLHCPHYSCALLBACK(PAVLHCPHYSNODECORE pNode, void *pvUser);
849	/** Pointer to callback function for RTAvlHCPhysDoWithAll() and RTAvlHCPhysDestroy(). */
850	typedef AVLHCPHYSCALLBACK *PAVLHCPHYSCALLBACK;
851
852	RTDECL(bool) RTAvlHCPhysInsert(PAVLHCPHYSTREE pTree, PAVLHCPHYSNODECORE pNode);
853	RTDECL(PAVLHCPHYSNODECORE) RTAvlHCPhysRemove(PAVLHCPHYSTREE pTree, RTHCPHYS Key);
854	RTDECL(PAVLHCPHYSNODECORE) RTAvlHCPhysGet(PAVLHCPHYSTREE pTree, RTHCPHYS Key);
855	RTDECL(int) RTAvlHCPhysDoWithAll(PAVLHCPHYSTREE pTree, int fFromLeft, PAVLHCPHYSCALLBACK pfnCallBack, void *pvParam);
856	RTDECL(PAVLHCPHYSNODECORE) RTAvlHCPhysGetBestFit(PAVLHCPHYSTREE ppTree, RTHCPHYS Key, bool fAbove);
857	RTDECL(PAVLHCPHYSNODECORE) RTAvlHCPhysRemoveBestFit(PAVLHCPHYSTREE ppTree, RTHCPHYS Key, bool fAbove);
858	RTDECL(int) RTAvlHCPhysDestroy(PAVLHCPHYSTREE pTree, PAVLHCPHYSCALLBACK pfnCallBack, void *pvParam);
859
860	/** @} */
861
862
863	/** @} */
864
865	__END_DECLS
866
867	#endif
868

Note: See TracBrowser for help on using the repository browser.

source: vbox/trunk/include/iprt/avl.h@ 19559

Download in other formats: