avl.h@ 47908

Last change on this file since 47908 was 44528, checked in by vboxsync, 12 years ago
header (C) fixes
Property svn:eol-style set to `native` Property svn:keywords set to `Author Date Id Revision`
File size: 45.7 KB

Line
1	/** @file
2	* IPRT - AVL Trees.
3	*/
4
5	/*
6	* Copyright (C) 1999-2012 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
26	#ifndef ___iprt_avl_h
27	#define ___iprt_avl_h
28
29	#include <iprt/cdefs.h>
30	#include <iprt/types.h>
31
32	RT_C_DECLS_BEGIN
33
34	/** @defgroup grp_rt_avl RTAvl - AVL Trees
35	* @ingroup grp_rt
36	* @{
37	*/
38
39
40	/** AVL tree of void pointers.
41	* @{
42	*/
43
44	/**
45	* AVL key type
46	*/
47	typedef void * AVLPVKEY;
48
49	/**
50	* AVL Core node.
51	*/
52	typedef struct _AVLPVNodeCore
53	{
54	AVLPVKEY Key; /** Key value. */
55	struct _AVLPVNodeCore pLeft; /* Pointer to left leaf node. */
56	struct _AVLPVNodeCore pRight; /* Pointer to right leaf node. */
57	unsigned char uchHeight; /** Height of this tree: max(height(left), height(right)) + 1 */
58	} AVLPVNODECORE, PAVLPVNODECORE, *PPAVLPVNODECORE;
59
60	/** A tree with void pointer keys. */
61	typedef PAVLPVNODECORE AVLPVTREE;
62	/** Pointer to a tree with void pointer keys. */
63	typedef PPAVLPVNODECORE PAVLPVTREE;
64
65	/** Callback function for AVLPVDoWithAll(). */
66	typedef DECLCALLBACK(int) AVLPVCALLBACK(PAVLPVNODECORE, void *);
67	/** Pointer to callback function for AVLPVDoWithAll(). */
68	typedef AVLPVCALLBACK *PAVLPVCALLBACK;
69
70	/*
71	* Functions.
72	*/
73	RTDECL(bool) RTAvlPVInsert(PAVLPVTREE ppTree, PAVLPVNODECORE pNode);
74	RTDECL(PAVLPVNODECORE) RTAvlPVRemove(PAVLPVTREE ppTree, AVLPVKEY Key);
75	RTDECL(PAVLPVNODECORE) RTAvlPVGet(PAVLPVTREE ppTree, AVLPVKEY Key);
76	RTDECL(PAVLPVNODECORE) RTAvlPVGetBestFit(PAVLPVTREE ppTree, AVLPVKEY Key, bool fAbove);
77	RTDECL(PAVLPVNODECORE) RTAvlPVRemoveBestFit(PAVLPVTREE ppTree, AVLPVKEY Key, bool fAbove);
78	RTDECL(int) RTAvlPVDoWithAll(PAVLPVTREE ppTree, int fFromLeft, PAVLPVCALLBACK pfnCallBack, void *pvParam);
79	RTDECL(int) RTAvlPVDestroy(PAVLPVTREE ppTree, PAVLPVCALLBACK pfnCallBack, void *pvParam);
80
81	/** @} */
82
83
84	/** AVL tree of unsigned long.
85	* @{
86	*/
87
88	/**
89	* AVL key type
90	*/
91	typedef unsigned long AVLULKEY;
92
93	/**
94	* AVL Core node.
95	*/
96	typedef struct _AVLULNodeCore
97	{
98	AVLULKEY Key; /** Key value. */
99	struct _AVLULNodeCore pLeft; /* Pointer to left leaf node. */
100	struct _AVLULNodeCore pRight; /* Pointer to right leaf node. */
101	unsigned char uchHeight; /** Height of this tree: max(height(left), height(right)) + 1 */
102	} AVLULNODECORE, PAVLULNODECORE, *PPAVLULNODECORE;
103
104
105	/** Callback function for AVLULDoWithAll(). */
106	typedef DECLCALLBACK(int) AVLULCALLBACK(PAVLULNODECORE, void*);
107	/** Pointer to callback function for AVLULDoWithAll(). */
108	typedef AVLULCALLBACK *PAVLULCALLBACK;
109
110
111	/*
112	* Functions.
113	*/
114	RTDECL(bool) RTAvlULInsert(PPAVLULNODECORE ppTree, PAVLULNODECORE pNode);
115	RTDECL(PAVLULNODECORE) RTAvlULRemove(PPAVLULNODECORE ppTree, AVLULKEY Key);
116	RTDECL(PAVLULNODECORE) RTAvlULGet(PPAVLULNODECORE ppTree, AVLULKEY Key);
117	RTDECL(PAVLULNODECORE) RTAvlULGetBestFit(PPAVLULNODECORE ppTree, AVLULKEY Key, bool fAbove);
118	RTDECL(PAVLULNODECORE) RTAvlULRemoveBestFit(PPAVLULNODECORE ppTree, AVLULKEY Key, bool fAbove);
119	RTDECL(int) RTAvlULDoWithAll(PPAVLULNODECORE ppTree, int fFromLeft, PAVLULCALLBACK pfnCallBack, void *pvParam);
120	RTDECL(int) RTAvlULDestroy(PPAVLULNODECORE pTree, PAVLULCALLBACK pfnCallBack, void *pvParam);
121
122	/** @} */
123
124
125
126	/** AVL tree of void pointer ranges.
127	* @{
128	*/
129
130	/**
131	* AVL key type
132	*/
133	typedef void *AVLRPVKEY;
134
135	/**
136	* AVL Core node.
137	*/
138	typedef struct AVLRPVNodeCore
139	{
140	AVLRPVKEY Key; /*< First key value in the range (inclusive). /
141	AVLRPVKEY KeyLast; /*< Last key value in the range (inclusive). /
142	struct AVLRPVNodeCore pLeft; /< Pointer to left leaf node. /
143	struct AVLRPVNodeCore pRight; /< Pointer to right leaf node. /
144	unsigned char uchHeight; /*< Height of this tree: max(height(left), height(right)) + 1 /
145	} AVLRPVNODECORE, PAVLRPVNODECORE, *PPAVLRPVNODECORE;
146
147	/** A tree with void pointer keys. */
148	typedef PAVLRPVNODECORE AVLRPVTREE;
149	/** Pointer to a tree with void pointer keys. */
150	typedef PPAVLRPVNODECORE PAVLRPVTREE;
151
152	/** Callback function for AVLPVDoWithAll(). */
153	typedef DECLCALLBACK(int) AVLRPVCALLBACK(PAVLRPVNODECORE, void *);
154	/** Pointer to callback function for AVLPVDoWithAll(). */
155	typedef AVLRPVCALLBACK *PAVLRPVCALLBACK;
156
157	/*
158	* Functions.
159	*/
160	RTDECL(bool) RTAvlrPVInsert(PAVLRPVTREE ppTree, PAVLRPVNODECORE pNode);
161	RTDECL(PAVLRPVNODECORE) RTAvlrPVRemove(PAVLRPVTREE ppTree, AVLRPVKEY Key);
162	RTDECL(PAVLRPVNODECORE) RTAvlrPVGet(PAVLRPVTREE ppTree, AVLRPVKEY Key);
163	RTDECL(PAVLRPVNODECORE) RTAvlrPVRangeGet(PAVLRPVTREE ppTree, AVLRPVKEY Key);
164	RTDECL(PAVLRPVNODECORE) RTAvlrPVRangeRemove(PAVLRPVTREE ppTree, AVLRPVKEY Key);
165	RTDECL(PAVLRPVNODECORE) RTAvlrPVGetBestFit(PAVLRPVTREE ppTree, AVLRPVKEY Key, bool fAbove);
166	RTDECL(PAVLRPVNODECORE) RTAvlrPVRemoveBestFit(PAVLRPVTREE ppTree, AVLRPVKEY Key, bool fAbove);
167	RTDECL(int) RTAvlrPVDoWithAll(PAVLRPVTREE ppTree, int fFromLeft, PAVLRPVCALLBACK pfnCallBack, void *pvParam);
168	RTDECL(int) RTAvlrPVDestroy(PAVLRPVTREE ppTree, PAVLRPVCALLBACK pfnCallBack, void *pvParam);
169
170	/** @} */
171
172
173
174	/** AVL tree of uint32_t
175	* @{
176	*/
177
178	/** AVL key type. */
179	typedef uint32_t AVLU32KEY;
180
181	/** AVL Core node. */
182	typedef struct _AVLU32NodeCore
183	{
184	AVLU32KEY Key; /*< Key value. /
185	struct _AVLU32NodeCore pLeft; /< Pointer to left leaf node. /
186	struct _AVLU32NodeCore pRight; /< Pointer to right leaf node. /
187	unsigned char uchHeight; /*< Height of this tree: max(height(left), height(right)) + 1 /
188	} AVLU32NODECORE, PAVLU32NODECORE, *PPAVLU32NODECORE;
189
190	/** A tree with void pointer keys. */
191	typedef PAVLU32NODECORE AVLU32TREE;
192	/** Pointer to a tree with void pointer keys. */
193	typedef PPAVLU32NODECORE PAVLU32TREE;
194
195	/** Callback function for AVLU32DoWithAll() & AVLU32Destroy(). */
196	typedef DECLCALLBACK(int) AVLU32CALLBACK(PAVLU32NODECORE, void*);
197	/** Pointer to callback function for AVLU32DoWithAll() & AVLU32Destroy(). */
198	typedef AVLU32CALLBACK *PAVLU32CALLBACK;
199
200
201	/*
202	* Functions.
203	*/
204	RTDECL(bool) RTAvlU32Insert(PAVLU32TREE pTree, PAVLU32NODECORE pNode);
205	RTDECL(PAVLU32NODECORE) RTAvlU32Remove(PAVLU32TREE pTree, AVLU32KEY Key);
206	RTDECL(PAVLU32NODECORE) RTAvlU32Get(PAVLU32TREE pTree, AVLU32KEY Key);
207	RTDECL(PAVLU32NODECORE) RTAvlU32GetBestFit(PAVLU32TREE pTree, AVLU32KEY Key, bool fAbove);
208	RTDECL(PAVLU32NODECORE) RTAvlU32RemoveBestFit(PAVLU32TREE pTree, AVLU32KEY Key, bool fAbove);
209	RTDECL(int) RTAvlU32DoWithAll(PAVLU32TREE pTree, int fFromLeft, PAVLU32CALLBACK pfnCallBack, void *pvParam);
210	RTDECL(int) RTAvlU32Destroy(PAVLU32TREE pTree, PAVLU32CALLBACK pfnCallBack, void *pvParam);
211
212	/** @} */
213
214	/**
215	* AVL uint32_t type for the relative offset pointer scheme.
216	*/
217	typedef int32_t AVLOU32;
218
219	typedef uint32_t AVLOU32KEY;
220
221	/**
222	* AVL Core node.
223	*/
224	typedef struct _AVLOU32NodeCore
225	{
226	/** Key value. */
227	AVLOU32KEY Key;
228	/** Offset to the left leaf node, relative to this field. */
229	AVLOU32 pLeft;
230	/** Offset to the right leaf node, relative to this field. */
231	AVLOU32 pRight;
232	/** Height of this tree: max(height(left), height(right)) + 1 */
233	unsigned char uchHeight;
234	} AVLOU32NODECORE, *PAVLOU32NODECORE;
235
236	/** A offset base tree with uint32_t keys. */
237	typedef AVLOU32 AVLOU32TREE;
238	/** Pointer to an offset base tree with uint32_t keys. */
239	typedef AVLOU32TREE *PAVLOU32TREE;
240
241	/** Pointer to an internal tree pointer.
242	* In this case it's a pointer to a relative offset. */
243	typedef AVLOU32TREE *PPAVLOU32NODECORE;
244
245	/** Callback function for RTAvloU32DoWithAll(). */
246	typedef DECLCALLBACK(int) AVLOU32CALLBACK(PAVLOU32NODECORE pNode, void *pvUser);
247	/** Pointer to callback function for RTAvloU32DoWithAll(). */
248	typedef AVLOU32CALLBACK *PAVLOU32CALLBACK;
249
250	RTDECL(bool) RTAvloU32Insert(PAVLOU32TREE pTree, PAVLOU32NODECORE pNode);
251	RTDECL(PAVLOU32NODECORE) RTAvloU32Remove(PAVLOU32TREE pTree, AVLOU32KEY Key);
252	RTDECL(PAVLOU32NODECORE) RTAvloU32Get(PAVLOU32TREE pTree, AVLOU32KEY Key);
253	RTDECL(int) RTAvloU32DoWithAll(PAVLOU32TREE pTree, int fFromLeft, PAVLOU32CALLBACK pfnCallBack, void *pvParam);
254	RTDECL(PAVLOU32NODECORE) RTAvloU32GetBestFit(PAVLOU32TREE ppTree, AVLOU32KEY Key, bool fAbove);
255	RTDECL(PAVLOU32NODECORE) RTAvloU32RemoveBestFit(PAVLOU32TREE ppTree, AVLOU32KEY Key, bool fAbove);
256	RTDECL(int) RTAvloU32Destroy(PAVLOU32TREE pTree, PAVLOU32CALLBACK pfnCallBack, void *pvParam);
257
258	/** @} */
259
260
261	/** AVL tree of uint32_t, list duplicates.
262	* @{
263	*/
264
265	/** AVL key type. */
266	typedef uint32_t AVLLU32KEY;
267
268	/** AVL Core node. */
269	typedef struct _AVLLU32NodeCore
270	{
271	AVLLU32KEY Key; /*< Key value. /
272	unsigned char uchHeight; /*< Height of this tree: max(height(left), height(right)) + 1 /
273	struct _AVLLU32NodeCore pLeft; /< Pointer to left leaf node. /
274	struct _AVLLU32NodeCore pRight; /< Pointer to right leaf node. /
275	struct _AVLLU32NodeCore pList; /< Pointer to next node with the same key. /
276	} AVLLU32NODECORE, PAVLLU32NODECORE, *PPAVLLU32NODECORE;
277
278	/** Callback function for RTAvllU32DoWithAll() & RTAvllU32Destroy(). */
279	typedef DECLCALLBACK(int) AVLLU32CALLBACK(PAVLLU32NODECORE, void*);
280	/** Pointer to callback function for RTAvllU32DoWithAll() & RTAvllU32Destroy(). */
281	typedef AVLLU32CALLBACK *PAVLLU32CALLBACK;
282
283
284	/*
285	* Functions.
286	*/
287	RTDECL(bool) RTAvllU32Insert(PPAVLLU32NODECORE ppTree, PAVLLU32NODECORE pNode);
288	RTDECL(PAVLLU32NODECORE) RTAvllU32Remove(PPAVLLU32NODECORE ppTree, AVLLU32KEY Key);
289	RTDECL(PAVLLU32NODECORE) RTAvllU32RemoveNode(PPAVLLU32NODECORE ppTree, PAVLLU32NODECORE pNode);
290	RTDECL(PAVLLU32NODECORE) RTAvllU32Get(PPAVLLU32NODECORE ppTree, AVLLU32KEY Key);
291	RTDECL(PAVLLU32NODECORE) RTAvllU32GetBestFit(PPAVLLU32NODECORE ppTree, AVLLU32KEY Key, bool fAbove);
292	RTDECL(PAVLLU32NODECORE) RTAvllU32RemoveBestFit(PPAVLLU32NODECORE ppTree, AVLLU32KEY Key, bool fAbove);
293	RTDECL(int) RTAvllU32DoWithAll(PPAVLLU32NODECORE ppTree, int fFromLeft, PAVLLU32CALLBACK pfnCallBack, void *pvParam);
294	RTDECL(int) RTAvllU32Destroy(PPAVLLU32NODECORE pTree, PAVLLU32CALLBACK pfnCallBack, void *pvParam);
295
296	/** @} */
297
298
299
300	/** AVL tree of uint64_t ranges.
301	* @{
302	*/
303
304	/**
305	* AVL key type
306	*/
307	typedef uint64_t AVLRU64KEY;
308
309	/**
310	* AVL Core node.
311	*/
312	typedef struct AVLRU64NodeCore
313	{
314	AVLRU64KEY Key; /*< First key value in the range (inclusive). /
315	AVLRU64KEY KeyLast; /*< Last key value in the range (inclusive). /
316	struct AVLRU64NodeCore pLeft; /< Pointer to left leaf node. /
317	struct AVLRU64NodeCore pRight; /< Pointer to right leaf node. /
318	unsigned char uchHeight; /*< Height of this tree: max(height(left), height(right)) + 1 /
319	} AVLRU64NODECORE, PAVLRU64NODECORE, *PPAVLRU64NODECORE;
320
321	/** A tree with void pointer keys. */
322	typedef PAVLRU64NODECORE AVLRU64TREE;
323	/** Pointer to a tree with void pointer keys. */
324	typedef PPAVLRU64NODECORE PAVLRU64TREE;
325
326	/** Callback function for AVLRU64DoWithAll(). */
327	typedef DECLCALLBACK(int) AVLRU64CALLBACK(PAVLRU64NODECORE, void *);
328	/** Pointer to callback function for AVLU64DoWithAll(). */
329	typedef AVLRU64CALLBACK *PAVLRU64CALLBACK;
330
331	/*
332	* Functions.
333	*/
334	RTDECL(bool) RTAvlrU64Insert(PAVLRU64TREE ppTree, PAVLRU64NODECORE pNode);
335	RTDECL(PAVLRU64NODECORE) RTAvlrU64Remove(PAVLRU64TREE ppTree, AVLRU64KEY Key);
336	RTDECL(PAVLRU64NODECORE) RTAvlrU64Get(PAVLRU64TREE ppTree, AVLRU64KEY Key);
337	RTDECL(PAVLRU64NODECORE) RTAvlrU64RangeGet(PAVLRU64TREE ppTree, AVLRU64KEY Key);
338	RTDECL(PAVLRU64NODECORE) RTAvlrU64RangeRemove(PAVLRU64TREE ppTree, AVLRU64KEY Key);
339	RTDECL(PAVLRU64NODECORE) RTAvlrU64GetBestFit(PAVLRU64TREE ppTree, AVLRU64KEY Key, bool fAbove);
340	RTDECL(PAVLRU64NODECORE) RTAvlrU64RemoveBestFit(PAVLRU64TREE ppTree, AVLRU64KEY Key, bool fAbove);
341	RTDECL(int) RTAvlrU64DoWithAll(PAVLRU64TREE ppTree, int fFromLeft, PAVLRU64CALLBACK pfnCallBack, void *pvParam);
342	RTDECL(int) RTAvlrU64Destroy(PAVLRU64TREE ppTree, PAVLRU64CALLBACK pfnCallBack, void *pvParam);
343
344	/** @} */
345
346
347
348	/** AVL tree of RTGCPHYSes - using relative offsets internally.
349	* @{
350	*/
351
352	/**
353	* AVL 'pointer' type for the relative offset pointer scheme.
354	*/
355	typedef int32_t AVLOGCPHYS;
356
357	/**
358	* AVL Core node.
359	*/
360	typedef struct _AVLOGCPhysNodeCore
361	{
362	/** Key value. */
363	RTGCPHYS Key;
364	/** Offset to the left leaf node, relative to this field. */
365	AVLOGCPHYS pLeft;
366	/** Offset to the right leaf node, relative to this field. */
367	AVLOGCPHYS pRight;
368	/** Height of this tree: max(height(left), height(right)) + 1 */
369	unsigned char uchHeight;
370	/** Padding */
371	unsigned char Padding[7];
372	} AVLOGCPHYSNODECORE, *PAVLOGCPHYSNODECORE;
373
374	/** A offset base tree with uint32_t keys. */
375	typedef AVLOGCPHYS AVLOGCPHYSTREE;
376	/** Pointer to an offset base tree with uint32_t keys. */
377	typedef AVLOGCPHYSTREE *PAVLOGCPHYSTREE;
378
379	/** Pointer to an internal tree pointer.
380	* In this case it's a pointer to a relative offset. */
381	typedef AVLOGCPHYSTREE *PPAVLOGCPHYSNODECORE;
382
383	/** Callback function for RTAvloGCPhysDoWithAll() and RTAvloGCPhysDestroy(). */
384	typedef DECLCALLBACK(int) AVLOGCPHYSCALLBACK(PAVLOGCPHYSNODECORE pNode, void *pvUser);
385	/** Pointer to callback function for RTAvloGCPhysDoWithAll() and RTAvloGCPhysDestroy(). */
386	typedef AVLOGCPHYSCALLBACK *PAVLOGCPHYSCALLBACK;
387
388	RTDECL(bool) RTAvloGCPhysInsert(PAVLOGCPHYSTREE pTree, PAVLOGCPHYSNODECORE pNode);
389	RTDECL(PAVLOGCPHYSNODECORE) RTAvloGCPhysRemove(PAVLOGCPHYSTREE pTree, RTGCPHYS Key);
390	RTDECL(PAVLOGCPHYSNODECORE) RTAvloGCPhysGet(PAVLOGCPHYSTREE pTree, RTGCPHYS Key);
391	RTDECL(int) RTAvloGCPhysDoWithAll(PAVLOGCPHYSTREE pTree, int fFromLeft, PAVLOGCPHYSCALLBACK pfnCallBack, void *pvParam);
392	RTDECL(PAVLOGCPHYSNODECORE) RTAvloGCPhysGetBestFit(PAVLOGCPHYSTREE ppTree, RTGCPHYS Key, bool fAbove);
393	RTDECL(PAVLOGCPHYSNODECORE) RTAvloGCPhysRemoveBestFit(PAVLOGCPHYSTREE ppTree, RTGCPHYS Key, bool fAbove);
394	RTDECL(int) RTAvloGCPhysDestroy(PAVLOGCPHYSTREE pTree, PAVLOGCPHYSCALLBACK pfnCallBack, void *pvParam);
395
396	/** @} */
397
398
399	/** AVL tree of RTGCPHYS ranges - using relative offsets internally.
400	* @{
401	*/
402
403	/**
404	* AVL 'pointer' type for the relative offset pointer scheme.
405	*/
406	typedef int32_t AVLROGCPHYS;
407
408	/**
409	* AVL Core node.
410	*/
411	typedef struct _AVLROGCPhysNodeCore
412	{
413	/** First key value in the range (inclusive). */
414	RTGCPHYS Key;
415	/** Last key value in the range (inclusive). */
416	RTGCPHYS KeyLast;
417	/** Offset to the left leaf node, relative to this field. */
418	AVLROGCPHYS pLeft;
419	/** Offset to the right leaf node, relative to this field. */
420	AVLROGCPHYS pRight;
421	/** Height of this tree: max(height(left), height(right)) + 1 */
422	unsigned char uchHeight;
423	/** Padding */
424	unsigned char Padding[7];
425	} AVLROGCPHYSNODECORE, *PAVLROGCPHYSNODECORE;
426
427	/** A offset base tree with uint32_t keys. */
428	typedef AVLROGCPHYS AVLROGCPHYSTREE;
429	/** Pointer to an offset base tree with uint32_t keys. */
430	typedef AVLROGCPHYSTREE *PAVLROGCPHYSTREE;
431
432	/** Pointer to an internal tree pointer.
433	* In this case it's a pointer to a relative offset. */
434	typedef AVLROGCPHYSTREE *PPAVLROGCPHYSNODECORE;
435
436	/** Callback function for RTAvlroGCPhysDoWithAll() and RTAvlroGCPhysDestroy(). */
437	typedef DECLCALLBACK(int) AVLROGCPHYSCALLBACK(PAVLROGCPHYSNODECORE pNode, void *pvUser);
438	/** Pointer to callback function for RTAvlroGCPhysDoWithAll() and RTAvlroGCPhysDestroy(). */
439	typedef AVLROGCPHYSCALLBACK *PAVLROGCPHYSCALLBACK;
440
441	RTDECL(bool) RTAvlroGCPhysInsert(PAVLROGCPHYSTREE pTree, PAVLROGCPHYSNODECORE pNode);
442	RTDECL(PAVLROGCPHYSNODECORE) RTAvlroGCPhysRemove(PAVLROGCPHYSTREE pTree, RTGCPHYS Key);
443	RTDECL(PAVLROGCPHYSNODECORE) RTAvlroGCPhysGet(PAVLROGCPHYSTREE pTree, RTGCPHYS Key);
444	RTDECL(PAVLROGCPHYSNODECORE) RTAvlroGCPhysRangeGet(PAVLROGCPHYSTREE pTree, RTGCPHYS Key);
445	RTDECL(PAVLROGCPHYSNODECORE) RTAvlroGCPhysRangeRemove(PAVLROGCPHYSTREE pTree, RTGCPHYS Key);
446	RTDECL(PAVLROGCPHYSNODECORE) RTAvlroGCPhysGetBestFit(PAVLROGCPHYSTREE ppTree, RTGCPHYS Key, bool fAbove);
447	RTDECL(int) RTAvlroGCPhysDoWithAll(PAVLROGCPHYSTREE pTree, int fFromLeft, PAVLROGCPHYSCALLBACK pfnCallBack, void *pvParam);
448	RTDECL(int) RTAvlroGCPhysDestroy(PAVLROGCPHYSTREE pTree, PAVLROGCPHYSCALLBACK pfnCallBack, void *pvParam);
449	RTDECL(PAVLROGCPHYSNODECORE) RTAvlroGCPhysGetRoot(PAVLROGCPHYSTREE pTree);
450	RTDECL(PAVLROGCPHYSNODECORE) RTAvlroGCPhysGetLeft(PAVLROGCPHYSNODECORE pNode);
451	RTDECL(PAVLROGCPHYSNODECORE) RTAvlroGCPhysGetRight(PAVLROGCPHYSNODECORE pNode);
452
453	/** @} */
454
455
456	/** AVL tree of RTGCPTRs.
457	* @{
458	*/
459
460	/**
461	* AVL Core node.
462	*/
463	typedef struct _AVLGCPtrNodeCore
464	{
465	/** Key value. */
466	RTGCPTR Key;
467	/** Pointer to the left node. */
468	struct _AVLGCPtrNodeCore *pLeft;
469	/** Pointer to the right node. */
470	struct _AVLGCPtrNodeCore *pRight;
471	/** Height of this tree: max(height(left), height(right)) + 1 */
472	unsigned char uchHeight;
473	} AVLGCPTRNODECORE, PAVLGCPTRNODECORE, *PPAVLGCPTRNODECORE;
474
475	/** A tree of RTGCPTR keys. */
476	typedef PAVLGCPTRNODECORE AVLGCPTRTREE;
477	/** Pointer to a tree of RTGCPTR keys. */
478	typedef PPAVLGCPTRNODECORE PAVLGCPTRTREE;
479
480	/** Callback function for RTAvlGCPtrDoWithAll(). */
481	typedef DECLCALLBACK(int) AVLGCPTRCALLBACK(PAVLGCPTRNODECORE pNode, void *pvUser);
482	/** Pointer to callback function for RTAvlGCPtrDoWithAll(). */
483	typedef AVLGCPTRCALLBACK *PAVLGCPTRCALLBACK;
484
485	RTDECL(bool) RTAvlGCPtrInsert(PAVLGCPTRTREE pTree, PAVLGCPTRNODECORE pNode);
486	RTDECL(PAVLGCPTRNODECORE) RTAvlGCPtrRemove(PAVLGCPTRTREE pTree, RTGCPTR Key);
487	RTDECL(PAVLGCPTRNODECORE) RTAvlGCPtrGet(PAVLGCPTRTREE pTree, RTGCPTR Key);
488	RTDECL(int) RTAvlGCPtrDoWithAll(PAVLGCPTRTREE pTree, int fFromLeft, PAVLGCPTRCALLBACK pfnCallBack, void *pvParam);
489	RTDECL(PAVLGCPTRNODECORE) RTAvlGCPtrGetBestFit(PAVLGCPTRTREE ppTree, RTGCPTR Key, bool fAbove);
490	RTDECL(PAVLGCPTRNODECORE) RTAvlGCPtrRemoveBestFit(PAVLGCPTRTREE ppTree, RTGCPTR Key, bool fAbove);
491	RTDECL(int) RTAvlGCPtrDestroy(PAVLGCPTRTREE pTree, PAVLGCPTRCALLBACK pfnCallBack, void *pvParam);
492
493	/** @} */
494
495
496	/** AVL tree of RTGCPTRs - using relative offsets internally.
497	* @{
498	*/
499
500	/**
501	* AVL 'pointer' type for the relative offset pointer scheme.
502	*/
503	typedef int32_t AVLOGCPTR;
504
505	/**
506	* AVL Core node.
507	*/
508	typedef struct _AVLOGCPtrNodeCore
509	{
510	/** Key value. */
511	RTGCPTR Key;
512	/** Offset to the left leaf node, relative to this field. */
513	AVLOGCPTR pLeft;
514	/** Offset to the right leaf node, relative to this field. */
515	AVLOGCPTR pRight;
516	/** Height of this tree: max(height(left), height(right)) + 1 */
517	unsigned char uchHeight;
518	unsigned char padding[GC_ARCH_BITS == 64 ? 7 : 3];
519	} AVLOGCPTRNODECORE, *PAVLOGCPTRNODECORE;
520
521	/** A offset base tree with uint32_t keys. */
522	typedef AVLOGCPTR AVLOGCPTRTREE;
523	/** Pointer to an offset base tree with uint32_t keys. */
524	typedef AVLOGCPTRTREE *PAVLOGCPTRTREE;
525
526	/** Pointer to an internal tree pointer.
527	* In this case it's a pointer to a relative offset. */
528	typedef AVLOGCPTRTREE *PPAVLOGCPTRNODECORE;
529
530	/** Callback function for RTAvloGCPtrDoWithAll(). */
531	typedef DECLCALLBACK(int) AVLOGCPTRCALLBACK(PAVLOGCPTRNODECORE pNode, void *pvUser);
532	/** Pointer to callback function for RTAvloGCPtrDoWithAll(). */
533	typedef AVLOGCPTRCALLBACK *PAVLOGCPTRCALLBACK;
534
535	RTDECL(bool) RTAvloGCPtrInsert(PAVLOGCPTRTREE pTree, PAVLOGCPTRNODECORE pNode);
536	RTDECL(PAVLOGCPTRNODECORE) RTAvloGCPtrRemove(PAVLOGCPTRTREE pTree, RTGCPTR Key);
537	RTDECL(PAVLOGCPTRNODECORE) RTAvloGCPtrGet(PAVLOGCPTRTREE pTree, RTGCPTR Key);
538	RTDECL(int) RTAvloGCPtrDoWithAll(PAVLOGCPTRTREE pTree, int fFromLeft, PAVLOGCPTRCALLBACK pfnCallBack, void *pvParam);
539	RTDECL(PAVLOGCPTRNODECORE) RTAvloGCPtrGetBestFit(PAVLOGCPTRTREE ppTree, RTGCPTR Key, bool fAbove);
540	RTDECL(PAVLOGCPTRNODECORE) RTAvloGCPtrRemoveBestFit(PAVLOGCPTRTREE ppTree, RTGCPTR Key, bool fAbove);
541	RTDECL(int) RTAvloGCPtrDestroy(PAVLOGCPTRTREE pTree, PAVLOGCPTRCALLBACK pfnCallBack, void *pvParam);
542
543	/** @} */
544
545
546	/** AVL tree of RTGCPTR ranges.
547	* @{
548	*/
549
550	/**
551	* AVL Core node.
552	*/
553	typedef struct _AVLRGCPtrNodeCore
554	{
555	/** First key value in the range (inclusive). */
556	RTGCPTR Key;
557	/** Last key value in the range (inclusive). */
558	RTGCPTR KeyLast;
559	/** Offset to the left leaf node, relative to this field. */
560	struct _AVLRGCPtrNodeCore *pLeft;
561	/** Offset to the right leaf node, relative to this field. */
562	struct _AVLRGCPtrNodeCore *pRight;
563	/** Height of this tree: max(height(left), height(right)) + 1 */
564	unsigned char uchHeight;
565	} AVLRGCPTRNODECORE, *PAVLRGCPTRNODECORE;
566
567	/** A offset base tree with RTGCPTR keys. */
568	typedef PAVLRGCPTRNODECORE AVLRGCPTRTREE;
569	/** Pointer to an offset base tree with RTGCPTR keys. */
570	typedef AVLRGCPTRTREE *PAVLRGCPTRTREE;
571
572	/** Pointer to an internal tree pointer.
573	* In this case it's a pointer to a relative offset. */
574	typedef AVLRGCPTRTREE *PPAVLRGCPTRNODECORE;
575
576	/** Callback function for RTAvlrGCPtrDoWithAll() and RTAvlrGCPtrDestroy(). */
577	typedef DECLCALLBACK(int) AVLRGCPTRCALLBACK(PAVLRGCPTRNODECORE pNode, void *pvUser);
578	/** Pointer to callback function for RTAvlrGCPtrDoWithAll() and RTAvlrGCPtrDestroy(). */
579	typedef AVLRGCPTRCALLBACK *PAVLRGCPTRCALLBACK;
580
581	RTDECL(bool) RTAvlrGCPtrInsert( PAVLRGCPTRTREE pTree, PAVLRGCPTRNODECORE pNode);
582	RTDECL(PAVLRGCPTRNODECORE) RTAvlrGCPtrRemove( PAVLRGCPTRTREE pTree, RTGCPTR Key);
583	RTDECL(PAVLRGCPTRNODECORE) RTAvlrGCPtrGet( PAVLRGCPTRTREE pTree, RTGCPTR Key);
584	RTDECL(PAVLRGCPTRNODECORE) RTAvlrGCPtrGetBestFit( PAVLRGCPTRTREE pTree, RTGCPTR Key, bool fAbove);
585	RTDECL(PAVLRGCPTRNODECORE) RTAvlrGCPtrRangeGet( PAVLRGCPTRTREE pTree, RTGCPTR Key);
586	RTDECL(PAVLRGCPTRNODECORE) RTAvlrGCPtrRangeRemove( PAVLRGCPTRTREE pTree, RTGCPTR Key);
587	RTDECL(int) RTAvlrGCPtrDoWithAll( PAVLRGCPTRTREE pTree, int fFromLeft, PAVLRGCPTRCALLBACK pfnCallBack, void *pvParam);
588	RTDECL(int) RTAvlrGCPtrDestroy( PAVLRGCPTRTREE pTree, PAVLRGCPTRCALLBACK pfnCallBack, void *pvParam);
589	RTDECL(PAVLRGCPTRNODECORE) RTAvlrGCPtrGetRoot( PAVLRGCPTRTREE pTree);
590	RTDECL(PAVLRGCPTRNODECORE) RTAvlrGCPtrGetLeft( PAVLRGCPTRNODECORE pNode);
591	RTDECL(PAVLRGCPTRNODECORE) RTAvlrGCPtrGetRight( PAVLRGCPTRNODECORE pNode);
592
593	/** @} */
594
595
596	/** AVL tree of RTGCPTR ranges - using relative offsets internally.
597	* @{
598	*/
599
600	/**
601	* AVL 'pointer' type for the relative offset pointer scheme.
602	*/
603	typedef int32_t AVLROGCPTR;
604
605	/**
606	* AVL Core node.
607	*/
608	typedef struct _AVLROGCPtrNodeCore
609	{
610	/** First key value in the range (inclusive). */
611	RTGCPTR Key;
612	/** Last key value in the range (inclusive). */
613	RTGCPTR KeyLast;
614	/** Offset to the left leaf node, relative to this field. */
615	AVLROGCPTR pLeft;
616	/** Offset to the right leaf node, relative to this field. */
617	AVLROGCPTR pRight;
618	/** Height of this tree: max(height(left), height(right)) + 1 */
619	unsigned char uchHeight;
620	unsigned char padding[GC_ARCH_BITS == 64 ? 7 : 7];
621	} AVLROGCPTRNODECORE, *PAVLROGCPTRNODECORE;
622
623	/** A offset base tree with uint32_t keys. */
624	typedef AVLROGCPTR AVLROGCPTRTREE;
625	/** Pointer to an offset base tree with uint32_t keys. */
626	typedef AVLROGCPTRTREE *PAVLROGCPTRTREE;
627
628	/** Pointer to an internal tree pointer.
629	* In this case it's a pointer to a relative offset. */
630	typedef AVLROGCPTRTREE *PPAVLROGCPTRNODECORE;
631
632	/** Callback function for RTAvlroGCPtrDoWithAll() and RTAvlroGCPtrDestroy(). */
633	typedef DECLCALLBACK(int) AVLROGCPTRCALLBACK(PAVLROGCPTRNODECORE pNode, void *pvUser);
634	/** Pointer to callback function for RTAvlroGCPtrDoWithAll() and RTAvlroGCPtrDestroy(). */
635	typedef AVLROGCPTRCALLBACK *PAVLROGCPTRCALLBACK;
636
637	RTDECL(bool) RTAvlroGCPtrInsert(PAVLROGCPTRTREE pTree, PAVLROGCPTRNODECORE pNode);
638	RTDECL(PAVLROGCPTRNODECORE) RTAvlroGCPtrRemove(PAVLROGCPTRTREE pTree, RTGCPTR Key);
639	RTDECL(PAVLROGCPTRNODECORE) RTAvlroGCPtrGet(PAVLROGCPTRTREE pTree, RTGCPTR Key);
640	RTDECL(PAVLROGCPTRNODECORE) RTAvlroGCPtrGetBestFit(PAVLROGCPTRTREE ppTree, RTGCPTR Key, bool fAbove);
641	RTDECL(PAVLROGCPTRNODECORE) RTAvlroGCPtrRangeGet(PAVLROGCPTRTREE pTree, RTGCPTR Key);
642	RTDECL(PAVLROGCPTRNODECORE) RTAvlroGCPtrRangeRemove(PAVLROGCPTRTREE pTree, RTGCPTR Key);
643	RTDECL(int) RTAvlroGCPtrDoWithAll(PAVLROGCPTRTREE pTree, int fFromLeft, PAVLROGCPTRCALLBACK pfnCallBack, void *pvParam);
644	RTDECL(int) RTAvlroGCPtrDestroy(PAVLROGCPTRTREE pTree, PAVLROGCPTRCALLBACK pfnCallBack, void *pvParam);
645	RTDECL(PAVLROGCPTRNODECORE) RTAvlroGCPtrGetRoot(PAVLROGCPTRTREE pTree);
646	RTDECL(PAVLROGCPTRNODECORE) RTAvlroGCPtrGetLeft(PAVLROGCPTRNODECORE pNode);
647	RTDECL(PAVLROGCPTRNODECORE) RTAvlroGCPtrGetRight(PAVLROGCPTRNODECORE pNode);
648
649	/** @} */
650
651
652	/** AVL tree of RTGCPTR ranges (overlapping supported) - using relative offsets internally.
653	* @{
654	*/
655
656	/**
657	* AVL 'pointer' type for the relative offset pointer scheme.
658	*/
659	typedef int32_t AVLROOGCPTR;
660
661	/**
662	* AVL Core node.
663	*/
664	typedef struct _AVLROOGCPtrNodeCore
665	{
666	/** First key value in the range (inclusive). */
667	RTGCPTR Key;
668	/** Last key value in the range (inclusive). */
669	RTGCPTR KeyLast;
670	/** Offset to the left leaf node, relative to this field. */
671	AVLROOGCPTR pLeft;
672	/** Offset to the right leaf node, relative to this field. */
673	AVLROOGCPTR pRight;
674	/** Pointer to the list of string with the same key. Don't touch. */
675	AVLROOGCPTR pList;
676	/** Height of this tree: max(height(left), height(right)) + 1 */
677	unsigned char uchHeight;
678	} AVLROOGCPTRNODECORE, *PAVLROOGCPTRNODECORE;
679
680	/** A offset base tree with uint32_t keys. */
681	typedef AVLROOGCPTR AVLROOGCPTRTREE;
682	/** Pointer to an offset base tree with uint32_t keys. */
683	typedef AVLROOGCPTRTREE *PAVLROOGCPTRTREE;
684
685	/** Pointer to an internal tree pointer.
686	* In this case it's a pointer to a relative offset. */
687	typedef AVLROOGCPTRTREE *PPAVLROOGCPTRNODECORE;
688
689	/** Callback function for RTAvlrooGCPtrDoWithAll() and RTAvlrooGCPtrDestroy(). */
690	typedef DECLCALLBACK(int) AVLROOGCPTRCALLBACK(PAVLROOGCPTRNODECORE pNode, void *pvUser);
691	/** Pointer to callback function for RTAvlrooGCPtrDoWithAll() and RTAvlrooGCPtrDestroy(). */
692	typedef AVLROOGCPTRCALLBACK *PAVLROOGCPTRCALLBACK;
693
694	RTDECL(bool) RTAvlrooGCPtrInsert(PAVLROOGCPTRTREE pTree, PAVLROOGCPTRNODECORE pNode);
695	RTDECL(PAVLROOGCPTRNODECORE) RTAvlrooGCPtrRemove(PAVLROOGCPTRTREE pTree, RTGCPTR Key);
696	RTDECL(PAVLROOGCPTRNODECORE) RTAvlrooGCPtrGet(PAVLROOGCPTRTREE pTree, RTGCPTR Key);
697	RTDECL(PAVLROOGCPTRNODECORE) RTAvlrooGCPtrGetBestFit(PAVLROOGCPTRTREE ppTree, RTGCPTR Key, bool fAbove);
698	RTDECL(PAVLROOGCPTRNODECORE) RTAvlrooGCPtrRangeGet(PAVLROOGCPTRTREE pTree, RTGCPTR Key);
699	RTDECL(PAVLROOGCPTRNODECORE) RTAvlrooGCPtrRangeRemove(PAVLROOGCPTRTREE pTree, RTGCPTR Key);
700	RTDECL(int) RTAvlrooGCPtrDoWithAll(PAVLROOGCPTRTREE pTree, int fFromLeft, PAVLROOGCPTRCALLBACK pfnCallBack, void *pvParam);
701	RTDECL(int) RTAvlrooGCPtrDestroy(PAVLROOGCPTRTREE pTree, PAVLROOGCPTRCALLBACK pfnCallBack, void *pvParam);
702	RTDECL(PAVLROOGCPTRNODECORE) RTAvlrooGCPtrGetRoot(PAVLROOGCPTRTREE pTree);
703	RTDECL(PAVLROOGCPTRNODECORE) RTAvlrooGCPtrGetLeft(PAVLROOGCPTRNODECORE pNode);
704	RTDECL(PAVLROOGCPTRNODECORE) RTAvlrooGCPtrGetRight(PAVLROOGCPTRNODECORE pNode);
705	RTDECL(PAVLROOGCPTRNODECORE) RTAvlrooGCPtrGetNextEqual(PAVLROOGCPTRNODECORE pNode);
706
707	/** @} */
708
709
710	/** AVL tree of RTUINTPTR.
711	* @{
712	*/
713
714	/**
715	* AVL RTUINTPTR node core.
716	*/
717	typedef struct _AVLUIntPtrNodeCore
718	{
719	/** Key value. */
720	RTUINTPTR Key;
721	/** Offset to the left leaf node, relative to this field. */
722	struct _AVLUIntPtrNodeCore *pLeft;
723	/** Offset to the right leaf node, relative to this field. */
724	struct _AVLUIntPtrNodeCore *pRight;
725	/** Height of this tree: max(height(left), height(right)) + 1 */
726	unsigned char uchHeight;
727	} AVLUINTPTRNODECORE;
728	/** Pointer to a RTUINTPTR AVL node core.*/
729	typedef AVLUINTPTRNODECORE *PAVLUINTPTRNODECORE;
730
731	/** A pointer based tree with RTUINTPTR keys. */
732	typedef PAVLUINTPTRNODECORE AVLUINTPTRTREE;
733	/** Pointer to an offset base tree with RTUINTPTR keys. */
734	typedef AVLUINTPTRTREE *PAVLUINTPTRTREE;
735
736	/** Pointer to an internal tree pointer.
737	* In this case it's a pointer to a pointer. */
738	typedef AVLUINTPTRTREE *PPAVLUINTPTRNODECORE;
739
740	/** Callback function for RTAvlUIntPtrDoWithAll() and RTAvlUIntPtrDestroy(). */
741	typedef DECLCALLBACK(int) AVLUINTPTRCALLBACK(PAVLUINTPTRNODECORE pNode, void *pvUser);
742	/** Pointer to callback function for RTAvlUIntPtrDoWithAll() and RTAvlUIntPtrDestroy(). */
743	typedef AVLUINTPTRCALLBACK *PAVLUINTPTRCALLBACK;
744
745	RTDECL(bool) RTAvlUIntPtrInsert( PAVLUINTPTRTREE pTree, PAVLUINTPTRNODECORE pNode);
746	RTDECL(PAVLUINTPTRNODECORE) RTAvlUIntPtrRemove( PAVLUINTPTRTREE pTree, RTUINTPTR Key);
747	RTDECL(PAVLUINTPTRNODECORE) RTAvlUIntPtrGet( PAVLUINTPTRTREE pTree, RTUINTPTR Key);
748	RTDECL(PAVLUINTPTRNODECORE) RTAvlUIntPtrGetBestFit(PAVLUINTPTRTREE pTree, RTUINTPTR Key, bool fAbove);
749	RTDECL(int) RTAvlUIntPtrDoWithAll( PAVLUINTPTRTREE pTree, int fFromLeft, PAVLUINTPTRCALLBACK pfnCallBack, void *pvParam);
750	RTDECL(int) RTAvlUIntPtrDestroy( PAVLUINTPTRTREE pTree, PAVLUINTPTRCALLBACK pfnCallBack, void *pvParam);
751	RTDECL(PAVLUINTPTRNODECORE) RTAvlUIntPtrGetRoot( PAVLUINTPTRTREE pTree);
752	RTDECL(PAVLUINTPTRNODECORE) RTAvlUIntPtrGetLeft( PAVLUINTPTRNODECORE pNode);
753	RTDECL(PAVLUINTPTRNODECORE) RTAvlUIntPtrGetRight( PAVLUINTPTRNODECORE pNode);
754
755	/** @} */
756
757
758	/** AVL tree of RTUINTPTR ranges.
759	* @{
760	*/
761
762	/**
763	* AVL RTUINTPTR range node core.
764	*/
765	typedef struct _AVLRUIntPtrNodeCore
766	{
767	/** First key value in the range (inclusive). */
768	RTUINTPTR Key;
769	/** Last key value in the range (inclusive). */
770	RTUINTPTR KeyLast;
771	/** Offset to the left leaf node, relative to this field. */
772	struct _AVLRUIntPtrNodeCore *pLeft;
773	/** Offset to the right leaf node, relative to this field. */
774	struct _AVLRUIntPtrNodeCore *pRight;
775	/** Height of this tree: max(height(left), height(right)) + 1 */
776	unsigned char uchHeight;
777	} AVLRUINTPTRNODECORE;
778	/** Pointer to an AVL RTUINTPTR range node code. */
779	typedef AVLRUINTPTRNODECORE *PAVLRUINTPTRNODECORE;
780
781	/** A pointer based tree with RTUINTPTR ranges. */
782	typedef PAVLRUINTPTRNODECORE AVLRUINTPTRTREE;
783	/** Pointer to a pointer based tree with RTUINTPTR ranges. */
784	typedef AVLRUINTPTRTREE *PAVLRUINTPTRTREE;
785
786	/** Pointer to an internal tree pointer.
787	* In this case it's a pointer to a pointer. */
788	typedef AVLRUINTPTRTREE *PPAVLRUINTPTRNODECORE;
789
790	/** Callback function for RTAvlrUIntPtrDoWithAll() and RTAvlrUIntPtrDestroy(). */
791	typedef DECLCALLBACK(int) AVLRUINTPTRCALLBACK(PAVLRUINTPTRNODECORE pNode, void *pvUser);
792	/** Pointer to callback function for RTAvlrUIntPtrDoWithAll() and RTAvlrUIntPtrDestroy(). */
793	typedef AVLRUINTPTRCALLBACK *PAVLRUINTPTRCALLBACK;
794
795	RTDECL(bool) RTAvlrUIntPtrInsert( PAVLRUINTPTRTREE pTree, PAVLRUINTPTRNODECORE pNode);
796	RTDECL(PAVLRUINTPTRNODECORE) RTAvlrUIntPtrRemove( PAVLRUINTPTRTREE pTree, RTUINTPTR Key);
797	RTDECL(PAVLRUINTPTRNODECORE) RTAvlrUIntPtrGet( PAVLRUINTPTRTREE pTree, RTUINTPTR Key);
798	RTDECL(PAVLRUINTPTRNODECORE) RTAvlrUIntPtrGetBestFit( PAVLRUINTPTRTREE pTree, RTUINTPTR Key, bool fAbove);
799	RTDECL(PAVLRUINTPTRNODECORE) RTAvlrUIntPtrRangeGet( PAVLRUINTPTRTREE pTree, RTUINTPTR Key);
800	RTDECL(PAVLRUINTPTRNODECORE) RTAvlrUIntPtrRangeRemove(PAVLRUINTPTRTREE pTree, RTUINTPTR Key);
801	RTDECL(int) RTAvlrUIntPtrDoWithAll( PAVLRUINTPTRTREE pTree, int fFromLeft, PAVLRUINTPTRCALLBACK pfnCallBack, void *pvParam);
802	RTDECL(int) RTAvlrUIntPtrDestroy( PAVLRUINTPTRTREE pTree, PAVLRUINTPTRCALLBACK pfnCallBack, void *pvParam);
803	RTDECL(PAVLRUINTPTRNODECORE) RTAvlrUIntPtrGetRoot( PAVLRUINTPTRTREE pTree);
804	RTDECL(PAVLRUINTPTRNODECORE) RTAvlrUIntPtrGetLeft( PAVLRUINTPTRNODECORE pNode);
805	RTDECL(PAVLRUINTPTRNODECORE) RTAvlrUIntPtrGetRight( PAVLRUINTPTRNODECORE pNode);
806
807	/** @} */
808
809
810	/** AVL tree of RTHCPHYSes - using relative offsets internally.
811	* @{
812	*/
813
814	/**
815	* AVL 'pointer' type for the relative offset pointer scheme.
816	*/
817	typedef int32_t AVLOHCPHYS;
818
819	/**
820	* AVL Core node.
821	*/
822	typedef struct _AVLOHCPhysNodeCore
823	{
824	/** Key value. */
825	RTHCPHYS Key;
826	/** Offset to the left leaf node, relative to this field. */
827	AVLOHCPHYS pLeft;
828	/** Offset to the right leaf node, relative to this field. */
829	AVLOHCPHYS pRight;
830	/** Height of this tree: max(height(left), height(right)) + 1 */
831	unsigned char uchHeight;
832	#if HC_ARCH_BITS == 64 \|\| GC_ARCH_BITS == 64
833	unsigned char Padding[7]; /*< Alignment padding. /
834	#endif
835	} AVLOHCPHYSNODECORE, *PAVLOHCPHYSNODECORE;
836
837	/** A offset base tree with uint32_t keys. */
838	typedef AVLOHCPHYS AVLOHCPHYSTREE;
839	/** Pointer to an offset base tree with uint32_t keys. */
840	typedef AVLOHCPHYSTREE *PAVLOHCPHYSTREE;
841
842	/** Pointer to an internal tree pointer.
843	* In this case it's a pointer to a relative offset. */
844	typedef AVLOHCPHYSTREE *PPAVLOHCPHYSNODECORE;
845
846	/** Callback function for RTAvloHCPhysDoWithAll() and RTAvloHCPhysDestroy(). */
847	typedef DECLCALLBACK(int) AVLOHCPHYSCALLBACK(PAVLOHCPHYSNODECORE pNode, void *pvUser);
848	/** Pointer to callback function for RTAvloHCPhysDoWithAll() and RTAvloHCPhysDestroy(). */
849	typedef AVLOHCPHYSCALLBACK *PAVLOHCPHYSCALLBACK;
850
851	RTDECL(bool) RTAvloHCPhysInsert(PAVLOHCPHYSTREE pTree, PAVLOHCPHYSNODECORE pNode);
852	RTDECL(PAVLOHCPHYSNODECORE) RTAvloHCPhysRemove(PAVLOHCPHYSTREE pTree, RTHCPHYS Key);
853	RTDECL(PAVLOHCPHYSNODECORE) RTAvloHCPhysGet(PAVLOHCPHYSTREE pTree, RTHCPHYS Key);
854	RTDECL(int) RTAvloHCPhysDoWithAll(PAVLOHCPHYSTREE pTree, int fFromLeft, PAVLOHCPHYSCALLBACK pfnCallBack, void *pvParam);
855	RTDECL(PAVLOHCPHYSNODECORE) RTAvloHCPhysGetBestFit(PAVLOHCPHYSTREE ppTree, RTHCPHYS Key, bool fAbove);
856	RTDECL(PAVLOHCPHYSNODECORE) RTAvloHCPhysRemoveBestFit(PAVLOHCPHYSTREE ppTree, RTHCPHYS Key, bool fAbove);
857	RTDECL(int) RTAvloHCPhysDestroy(PAVLOHCPHYSTREE pTree, PAVLOHCPHYSCALLBACK pfnCallBack, void *pvParam);
858
859	/** @} */
860
861
862
863	/** AVL tree of RTIOPORTs - using relative offsets internally.
864	* @{
865	*/
866
867	/**
868	* AVL 'pointer' type for the relative offset pointer scheme.
869	*/
870	typedef int32_t AVLOIOPORTPTR;
871
872	/**
873	* AVL Core node.
874	*/
875	typedef struct _AVLOIOPortNodeCore
876	{
877	/** Offset to the left leaf node, relative to this field. */
878	AVLOIOPORTPTR pLeft;
879	/** Offset to the right leaf node, relative to this field. */
880	AVLOIOPORTPTR pRight;
881	/** Key value. */
882	RTIOPORT Key;
883	/** Height of this tree: max(height(left), height(right)) + 1 */
884	unsigned char uchHeight;
885	} AVLOIOPORTNODECORE, *PAVLOIOPORTNODECORE;
886
887	/** A offset base tree with uint32_t keys. */
888	typedef AVLOIOPORTPTR AVLOIOPORTTREE;
889	/** Pointer to an offset base tree with uint32_t keys. */
890	typedef AVLOIOPORTTREE *PAVLOIOPORTTREE;
891
892	/** Pointer to an internal tree pointer.
893	* In this case it's a pointer to a relative offset. */
894	typedef AVLOIOPORTTREE *PPAVLOIOPORTNODECORE;
895
896	/** Callback function for RTAvloIOPortDoWithAll() and RTAvloIOPortDestroy(). */
897	typedef DECLCALLBACK(int) AVLOIOPORTCALLBACK(PAVLOIOPORTNODECORE pNode, void *pvUser);
898	/** Pointer to callback function for RTAvloIOPortDoWithAll() and RTAvloIOPortDestroy(). */
899	typedef AVLOIOPORTCALLBACK *PAVLOIOPORTCALLBACK;
900
901	RTDECL(bool) RTAvloIOPortInsert(PAVLOIOPORTTREE pTree, PAVLOIOPORTNODECORE pNode);
902	RTDECL(PAVLOIOPORTNODECORE) RTAvloIOPortRemove(PAVLOIOPORTTREE pTree, RTIOPORT Key);
903	RTDECL(PAVLOIOPORTNODECORE) RTAvloIOPortGet(PAVLOIOPORTTREE pTree, RTIOPORT Key);
904	RTDECL(int) RTAvloIOPortDoWithAll(PAVLOIOPORTTREE pTree, int fFromLeft, PAVLOIOPORTCALLBACK pfnCallBack, void *pvParam);
905	RTDECL(PAVLOIOPORTNODECORE) RTAvloIOPortGetBestFit(PAVLOIOPORTTREE ppTree, RTIOPORT Key, bool fAbove);
906	RTDECL(PAVLOIOPORTNODECORE) RTAvloIOPortRemoveBestFit(PAVLOIOPORTTREE ppTree, RTIOPORT Key, bool fAbove);
907	RTDECL(int) RTAvloIOPortDestroy(PAVLOIOPORTTREE pTree, PAVLOIOPORTCALLBACK pfnCallBack, void *pvParam);
908
909	/** @} */
910
911
912	/** AVL tree of RTIOPORT ranges - using relative offsets internally.
913	* @{
914	*/
915
916	/**
917	* AVL 'pointer' type for the relative offset pointer scheme.
918	*/
919	typedef int32_t AVLROIOPORTPTR;
920
921	/**
922	* AVL Core node.
923	*/
924	typedef struct _AVLROIOPortNodeCore
925	{
926	/** First key value in the range (inclusive). */
927	RTIOPORT Key;
928	/** Last key value in the range (inclusive). */
929	RTIOPORT KeyLast;
930	/** Offset to the left leaf node, relative to this field. */
931	AVLROIOPORTPTR pLeft;
932	/** Offset to the right leaf node, relative to this field. */
933	AVLROIOPORTPTR pRight;
934	/** Height of this tree: max(height(left), height(right)) + 1 */
935	unsigned char uchHeight;
936	} AVLROIOPORTNODECORE, *PAVLROIOPORTNODECORE;
937
938	/** A offset base tree with uint32_t keys. */
939	typedef AVLROIOPORTPTR AVLROIOPORTTREE;
940	/** Pointer to an offset base tree with uint32_t keys. */
941	typedef AVLROIOPORTTREE *PAVLROIOPORTTREE;
942
943	/** Pointer to an internal tree pointer.
944	* In this case it's a pointer to a relative offset. */
945	typedef AVLROIOPORTTREE *PPAVLROIOPORTNODECORE;
946
947	/** Callback function for RTAvlroIOPortDoWithAll() and RTAvlroIOPortDestroy(). */
948	typedef DECLCALLBACK(int) AVLROIOPORTCALLBACK(PAVLROIOPORTNODECORE pNode, void *pvUser);
949	/** Pointer to callback function for RTAvlroIOPortDoWithAll() and RTAvlroIOPortDestroy(). */
950	typedef AVLROIOPORTCALLBACK *PAVLROIOPORTCALLBACK;
951
952	RTDECL(bool) RTAvlroIOPortInsert(PAVLROIOPORTTREE pTree, PAVLROIOPORTNODECORE pNode);
953	RTDECL(PAVLROIOPORTNODECORE) RTAvlroIOPortRemove(PAVLROIOPORTTREE pTree, RTIOPORT Key);
954	RTDECL(PAVLROIOPORTNODECORE) RTAvlroIOPortGet(PAVLROIOPORTTREE pTree, RTIOPORT Key);
955	RTDECL(PAVLROIOPORTNODECORE) RTAvlroIOPortRangeGet(PAVLROIOPORTTREE pTree, RTIOPORT Key);
956	RTDECL(PAVLROIOPORTNODECORE) RTAvlroIOPortRangeRemove(PAVLROIOPORTTREE pTree, RTIOPORT Key);
957	RTDECL(int) RTAvlroIOPortDoWithAll(PAVLROIOPORTTREE pTree, int fFromLeft, PAVLROIOPORTCALLBACK pfnCallBack, void *pvParam);
958	RTDECL(int) RTAvlroIOPortDestroy(PAVLROIOPORTTREE pTree, PAVLROIOPORTCALLBACK pfnCallBack, void *pvParam);
959
960	/** @} */
961
962
963	/** AVL tree of RTHCPHYSes.
964	* @{
965	*/
966
967	/**
968	* AVL 'pointer' type for the relative offset pointer scheme.
969	*/
970	typedef struct _AVLHCPhysNodeCore *AVLHCPHYSPTR;
971
972	/**
973	* AVL Core node.
974	*/
975	typedef struct _AVLHCPhysNodeCore
976	{
977	/** Offset to the left leaf node, relative to this field. */
978	AVLHCPHYSPTR pLeft;
979	/** Offset to the right leaf node, relative to this field. */
980	AVLHCPHYSPTR pRight;
981	/** Key value. */
982	RTHCPHYS Key;
983	/** Height of this tree: max(height(left), height(right)) + 1 */
984	unsigned char uchHeight;
985	} AVLHCPHYSNODECORE, *PAVLHCPHYSNODECORE;
986
987	/** A offset base tree with RTHCPHYS keys. */
988	typedef AVLHCPHYSPTR AVLHCPHYSTREE;
989	/** Pointer to an offset base tree with RTHCPHYS keys. */
990	typedef AVLHCPHYSTREE *PAVLHCPHYSTREE;
991
992	/** Pointer to an internal tree pointer.
993	* In this case it's a pointer to a relative offset. */
994	typedef AVLHCPHYSTREE *PPAVLHCPHYSNODECORE;
995
996	/** Callback function for RTAvlHCPhysDoWithAll() and RTAvlHCPhysDestroy(). */
997	typedef DECLCALLBACK(int) AVLHCPHYSCALLBACK(PAVLHCPHYSNODECORE pNode, void *pvUser);
998	/** Pointer to callback function for RTAvlHCPhysDoWithAll() and RTAvlHCPhysDestroy(). */
999	typedef AVLHCPHYSCALLBACK *PAVLHCPHYSCALLBACK;
1000
1001	RTDECL(bool) RTAvlHCPhysInsert(PAVLHCPHYSTREE pTree, PAVLHCPHYSNODECORE pNode);
1002	RTDECL(PAVLHCPHYSNODECORE) RTAvlHCPhysRemove(PAVLHCPHYSTREE pTree, RTHCPHYS Key);
1003	RTDECL(PAVLHCPHYSNODECORE) RTAvlHCPhysGet(PAVLHCPHYSTREE pTree, RTHCPHYS Key);
1004	RTDECL(int) RTAvlHCPhysDoWithAll(PAVLHCPHYSTREE pTree, int fFromLeft, PAVLHCPHYSCALLBACK pfnCallBack, void *pvParam);
1005	RTDECL(PAVLHCPHYSNODECORE) RTAvlHCPhysGetBestFit(PAVLHCPHYSTREE ppTree, RTHCPHYS Key, bool fAbove);
1006	RTDECL(PAVLHCPHYSNODECORE) RTAvlHCPhysRemoveBestFit(PAVLHCPHYSTREE ppTree, RTHCPHYS Key, bool fAbove);
1007	RTDECL(int) RTAvlHCPhysDestroy(PAVLHCPHYSTREE pTree, PAVLHCPHYSCALLBACK pfnCallBack, void *pvParam);
1008
1009	/** @} */
1010
1011	/** AVL tree of RTGCPHYSes.
1012	* @{
1013	*/
1014
1015	/**
1016	* AVL 'pointer' type for the relative offset pointer scheme.
1017	*/
1018	typedef struct _AVLGCPhysNodeCore *AVLGCPHYSPTR;
1019
1020	/**
1021	* AVL Core node.
1022	*/
1023	typedef struct _AVLGCPhysNodeCore
1024	{
1025	/** Offset to the left leaf node, relative to this field. */
1026	AVLGCPHYSPTR pLeft;
1027	/** Offset to the right leaf node, relative to this field. */
1028	AVLGCPHYSPTR pRight;
1029	/** Key value. */
1030	RTGCPHYS Key;
1031	/** Height of this tree: max(height(left), height(right)) + 1 */
1032	unsigned char uchHeight;
1033	} AVLGCPHYSNODECORE, *PAVLGCPHYSNODECORE;
1034
1035	/** A offset base tree with RTGCPHYS keys. */
1036	typedef AVLGCPHYSPTR AVLGCPHYSTREE;
1037	/** Pointer to an offset base tree with RTGCPHYS keys. */
1038	typedef AVLGCPHYSTREE *PAVLGCPHYSTREE;
1039
1040	/** Pointer to an internal tree pointer.
1041	* In this case it's a pointer to a relative offset. */
1042	typedef AVLGCPHYSTREE *PPAVLGCPHYSNODECORE;
1043
1044	/** Callback function for RTAvlGCPhysDoWithAll() and RTAvlGCPhysDestroy(). */
1045	typedef DECLCALLBACK(int) AVLGCPHYSCALLBACK(PAVLGCPHYSNODECORE pNode, void *pvUser);
1046	/** Pointer to callback function for RTAvlGCPhysDoWithAll() and RTAvlGCPhysDestroy(). */
1047	typedef AVLGCPHYSCALLBACK *PAVLGCPHYSCALLBACK;
1048
1049	RTDECL(bool) RTAvlGCPhysInsert(PAVLGCPHYSTREE pTree, PAVLGCPHYSNODECORE pNode);
1050	RTDECL(PAVLGCPHYSNODECORE) RTAvlGCPhysRemove(PAVLGCPHYSTREE pTree, RTGCPHYS Key);
1051	RTDECL(PAVLGCPHYSNODECORE) RTAvlGCPhysGet(PAVLGCPHYSTREE pTree, RTGCPHYS Key);
1052	RTDECL(int) RTAvlGCPhysDoWithAll(PAVLGCPHYSTREE pTree, int fFromLeft, PAVLGCPHYSCALLBACK pfnCallBack, void *pvParam);
1053	RTDECL(PAVLGCPHYSNODECORE) RTAvlGCPhysGetBestFit(PAVLGCPHYSTREE ppTree, RTGCPHYS Key, bool fAbove);
1054	RTDECL(PAVLGCPHYSNODECORE) RTAvlGCPhysRemoveBestFit(PAVLGCPHYSTREE ppTree, RTGCPHYS Key, bool fAbove);
1055	RTDECL(int) RTAvlGCPhysDestroy(PAVLGCPHYSTREE pTree, PAVLGCPHYSCALLBACK pfnCallBack, void *pvParam);
1056
1057	/** @} */
1058
1059
1060	/** AVL tree of RTFOFF ranges.
1061	* @{
1062	*/
1063
1064	/**
1065	* AVL Core node.
1066	*/
1067	typedef struct _AVLRFOFFNodeCore
1068	{
1069	/** First key value in the range (inclusive). */
1070	RTFOFF Key;
1071	/** Last key value in the range (inclusive). */
1072	RTFOFF KeyLast;
1073	/** Offset to the left leaf node, relative to this field. */
1074	struct _AVLRFOFFNodeCore *pLeft;
1075	/** Offset to the right leaf node, relative to this field. */
1076	struct _AVLRFOFFNodeCore *pRight;
1077	/** Height of this tree: max(height(left), height(right)) + 1 */
1078	unsigned char uchHeight;
1079	} AVLRFOFFNODECORE, *PAVLRFOFFNODECORE;
1080
1081	/** A pointer based tree with RTFOFF ranges. */
1082	typedef PAVLRFOFFNODECORE AVLRFOFFTREE;
1083	/** Pointer to a pointer based tree with RTFOFF ranges. */
1084	typedef AVLRFOFFTREE *PAVLRFOFFTREE;
1085
1086	/** Pointer to an internal tree pointer.
1087	* In this case it's a pointer to a relative offset. */
1088	typedef AVLRFOFFTREE *PPAVLRFOFFNODECORE;
1089
1090	/** Callback function for RTAvlrGCPtrDoWithAll() and RTAvlrGCPtrDestroy(). */
1091	typedef DECLCALLBACK(int) AVLRFOFFCALLBACK(PAVLRFOFFNODECORE pNode, void *pvUser);
1092	/** Pointer to callback function for RTAvlrGCPtrDoWithAll() and RTAvlrGCPtrDestroy(). */
1093	typedef AVLRFOFFCALLBACK *PAVLRFOFFCALLBACK;
1094
1095	RTDECL(bool) RTAvlrFileOffsetInsert( PAVLRFOFFTREE pTree, PAVLRFOFFNODECORE pNode);
1096	RTDECL(PAVLRFOFFNODECORE) RTAvlrFileOffsetRemove( PAVLRFOFFTREE pTree, RTFOFF Key);
1097	RTDECL(PAVLRFOFFNODECORE) RTAvlrFileOffsetGet( PAVLRFOFFTREE pTree, RTFOFF Key);
1098	RTDECL(PAVLRFOFFNODECORE) RTAvlrFileOffsetGetBestFit( PAVLRFOFFTREE pTree, RTFOFF Key, bool fAbove);
1099	RTDECL(PAVLRFOFFNODECORE) RTAvlrFileOffsetRangeGet( PAVLRFOFFTREE pTree, RTFOFF Key);
1100	RTDECL(PAVLRFOFFNODECORE) RTAvlrFileOffsetRangeRemove( PAVLRFOFFTREE pTree, RTFOFF Key);
1101	RTDECL(int) RTAvlrFileOffsetDoWithAll( PAVLRFOFFTREE pTree, int fFromLeft, PAVLRFOFFCALLBACK pfnCallBack, void *pvParam);
1102	RTDECL(int) RTAvlrFileOffsetDestroy( PAVLRFOFFTREE pTree, PAVLRFOFFCALLBACK pfnCallBack, void *pvParam);
1103	RTDECL(PAVLRFOFFNODECORE) RTAvlrFileOffsetGetRoot( PAVLRFOFFTREE pTree);
1104	RTDECL(PAVLRFOFFNODECORE) RTAvlrFileOffsetGetLeft( PAVLRFOFFNODECORE pNode);
1105	RTDECL(PAVLRFOFFNODECORE) RTAvlrFileOffsetGetRight( PAVLRFOFFNODECORE pNode);
1106
1107	/** @} */
1108
1109	/** @} */
1110
1111	RT_C_DECLS_END
1112
1113	#endif
1114

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

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

Download in other formats: