]> Pileus Git - ~andy/gtk/blob - gtk/gtkrbtree.c
279df205df4a483dc80c6e8bd84e737b2a365482
[~andy/gtk] / gtk / gtkrbtree.c
1 /* gtkrbtree.c
2  * Copyright (C) 2000  Red Hat, Inc.,  Jonathan Blandford <jrb@redhat.com>
3  *
4  * This library is free software; you can redistribute it and/or
5  * modify it under the terms of the GNU Library General Public
6  * License as published by the Free Software Foundation; either
7  * version 2 of the License, or (at your option) any later version.
8  *
9  * This library is distributed in the hope that it will be useful,
10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
12  * Library General Public License for more details.
13  *
14  * You should have received a copy of the GNU Library General Public
15  * License along with this library; if not, write to the
16  * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
17  * Boston, MA 02111-1307, USA.
18  */
19
20 #include "config.h"
21 #include "gtkrbtree.h"
22 #include "gtkdebug.h"
23
24 static GtkRBNode * _gtk_rbnode_new                (GtkRBTree  *tree,
25                                                    gint        height);
26 static void        _gtk_rbnode_free               (GtkRBNode  *node);
27 static void        _gtk_rbnode_rotate_left        (GtkRBTree  *tree,
28                                                    GtkRBNode  *node);
29 static void        _gtk_rbnode_rotate_right       (GtkRBTree  *tree,
30                                                    GtkRBNode  *node);
31 static void        _gtk_rbtree_insert_fixup       (GtkRBTree  *tree,
32                                                    GtkRBNode  *node);
33 static void        _gtk_rbtree_remove_node_fixup  (GtkRBTree  *tree,
34                                                    GtkRBNode  *node);
35 static inline void _fixup_validation              (GtkRBTree  *tree,
36                                                    GtkRBNode  *node);
37 static inline void _fixup_total_count             (GtkRBTree  *tree,
38                                                    GtkRBNode  *node);
39 #ifdef G_ENABLE_DEBUG  
40 static void        _gtk_rbtree_test               (const gchar *where,
41                                                    GtkRBTree  *tree);
42 static void        _gtk_rbtree_debug_spew         (GtkRBTree  *tree);
43 #endif
44
45
46
47 static GtkRBNode *
48 _gtk_rbnode_new (GtkRBTree *tree,
49                  gint       height)
50 {
51   GtkRBNode *node = g_slice_new (GtkRBNode);
52
53   node->left = tree->nil;
54   node->right = tree->nil;
55   node->parent = tree->nil;
56   node->flags = GTK_RBNODE_RED;
57   node->total_count = 1;
58   node->count = 1;
59   node->children = NULL;
60   node->offset = height;
61   return node;
62 }
63
64 static void
65 _gtk_rbnode_free (GtkRBNode *node)
66 {
67 #ifdef G_ENABLE_DEBUG
68   if (gtk_get_debug_flags () & GTK_DEBUG_TREE)
69     {
70       node->left = (gpointer) 0xdeadbeef;
71       node->right = (gpointer) 0xdeadbeef;
72       node->parent = (gpointer) 0xdeadbeef;
73       node->total_count = 56789;
74       node->offset = 56789;
75       node->count = 56789;
76       node->flags = 0;
77     }
78 #endif
79   g_slice_free (GtkRBNode, node);
80 }
81
82 static void
83 _gtk_rbnode_rotate_left (GtkRBTree *tree,
84                          GtkRBNode *node)
85 {
86   gint node_height, right_height;
87   GtkRBNode *right = node->right;
88
89   g_return_if_fail (node != tree->nil);
90
91   node_height = node->offset -
92     (node->left?node->left->offset:0) -
93     (node->right?node->right->offset:0) -
94     (node->children?node->children->root->offset:0);
95   right_height = right->offset -
96     (right->left?right->left->offset:0) -
97     (right->right?right->right->offset:0) -
98     (right->children?right->children->root->offset:0);
99   node->right = right->left;
100   if (right->left != tree->nil)
101     right->left->parent = node;
102
103   if (right != tree->nil)
104     right->parent = node->parent;
105   if (node->parent != tree->nil)
106     {
107       if (node == node->parent->left)
108         node->parent->left = right;
109       else
110         node->parent->right = right;
111     } else {
112       tree->root = right;
113     }
114
115   right->left = node;
116   if (node != tree->nil)
117     node->parent = right;
118
119   node->count = 1 + (node->left?node->left->count:0) +
120     (node->right?node->right->count:0);
121   right->count = 1 + (right->left?right->left->count:0) +
122     (right->right?right->right->count:0);
123
124   node->offset = node_height +
125     (node->left?node->left->offset:0) +
126     (node->right?node->right->offset:0) +
127     (node->children?node->children->root->offset:0);
128   right->offset = right_height +
129     (right->left?right->left->offset:0) +
130     (right->right?right->right->offset:0) +
131     (right->children?right->children->root->offset:0);
132
133   _fixup_validation (tree, node);
134   _fixup_validation (tree, right);
135   _fixup_total_count (tree, node);
136   _fixup_total_count (tree, right);
137 }
138
139 static void
140 _gtk_rbnode_rotate_right (GtkRBTree *tree,
141                           GtkRBNode *node)
142 {
143   gint node_height, left_height;
144   GtkRBNode *left = node->left;
145
146   g_return_if_fail (node != tree->nil);
147
148   node_height = node->offset -
149     (node->left?node->left->offset:0) -
150     (node->right?node->right->offset:0) -
151     (node->children?node->children->root->offset:0);
152   left_height = left->offset -
153     (left->left?left->left->offset:0) -
154     (left->right?left->right->offset:0) -
155     (left->children?left->children->root->offset:0);
156   
157   node->left = left->right;
158   if (left->right != tree->nil)
159     left->right->parent = node;
160
161   if (left != tree->nil)
162     left->parent = node->parent;
163   if (node->parent != tree->nil)
164     {
165       if (node == node->parent->right)
166         node->parent->right = left;
167       else
168         node->parent->left = left;
169     }
170   else
171     {
172       tree->root = left;
173     }
174
175   /* link node and left */
176   left->right = node;
177   if (node != tree->nil)
178     node->parent = left;
179
180   node->count = 1 + (node->left?node->left->count:0) +
181     (node->right?node->right->count:0);
182   left->count = 1 + (left->left?left->left->count:0) +
183     (left->right?left->right->count:0);
184
185   node->offset = node_height +
186     (node->left?node->left->offset:0) +
187     (node->right?node->right->offset:0) +
188     (node->children?node->children->root->offset:0);
189   left->offset = left_height +
190     (left->left?left->left->offset:0) +
191     (left->right?left->right->offset:0) +
192     (left->children?left->children->root->offset:0);
193
194   _fixup_validation (tree, node);
195   _fixup_validation (tree, left);
196   _fixup_total_count (tree, node);
197   _fixup_total_count (tree, left);
198 }
199
200 static void
201 _gtk_rbtree_insert_fixup (GtkRBTree *tree,
202                           GtkRBNode *node)
203 {
204
205   /* check Red-Black properties */
206   while (node != tree->root && GTK_RBNODE_GET_COLOR (node->parent) == GTK_RBNODE_RED)
207     {
208       /* we have a violation */
209       if (node->parent == node->parent->parent->left)
210         {
211           GtkRBNode *y = node->parent->parent->right;
212           if (GTK_RBNODE_GET_COLOR (y) == GTK_RBNODE_RED)
213             {
214                                 /* uncle is GTK_RBNODE_RED */
215               GTK_RBNODE_SET_COLOR (node->parent, GTK_RBNODE_BLACK);
216               GTK_RBNODE_SET_COLOR (y, GTK_RBNODE_BLACK);
217               GTK_RBNODE_SET_COLOR (node->parent->parent, GTK_RBNODE_RED);
218               node = node->parent->parent;
219             }
220           else
221             {
222                                 /* uncle is GTK_RBNODE_BLACK */
223               if (node == node->parent->right)
224                 {
225                   /* make node a left child */
226                   node = node->parent;
227                   _gtk_rbnode_rotate_left (tree, node);
228                 }
229
230                                 /* recolor and rotate */
231               GTK_RBNODE_SET_COLOR (node->parent, GTK_RBNODE_BLACK);
232               GTK_RBNODE_SET_COLOR (node->parent->parent, GTK_RBNODE_RED);
233               _gtk_rbnode_rotate_right(tree, node->parent->parent);
234             }
235         }
236       else
237         {
238           /* mirror image of above code */
239           GtkRBNode *y = node->parent->parent->left;
240           if (GTK_RBNODE_GET_COLOR (y) == GTK_RBNODE_RED)
241             {
242                                 /* uncle is GTK_RBNODE_RED */
243               GTK_RBNODE_SET_COLOR (node->parent, GTK_RBNODE_BLACK);
244               GTK_RBNODE_SET_COLOR (y, GTK_RBNODE_BLACK);
245               GTK_RBNODE_SET_COLOR (node->parent->parent, GTK_RBNODE_RED);
246               node = node->parent->parent;
247             }
248           else
249             {
250                                 /* uncle is GTK_RBNODE_BLACK */
251               if (node == node->parent->left)
252                 {
253                   node = node->parent;
254                   _gtk_rbnode_rotate_right (tree, node);
255                 }
256               GTK_RBNODE_SET_COLOR (node->parent, GTK_RBNODE_BLACK);
257               GTK_RBNODE_SET_COLOR (node->parent->parent, GTK_RBNODE_RED);
258               _gtk_rbnode_rotate_left (tree, node->parent->parent);
259             }
260         }
261     }
262   GTK_RBNODE_SET_COLOR (tree->root, GTK_RBNODE_BLACK);
263 }
264
265 static void
266 _gtk_rbtree_remove_node_fixup (GtkRBTree *tree,
267                                GtkRBNode *node)
268 {
269   while (node != tree->root && GTK_RBNODE_GET_COLOR (node) == GTK_RBNODE_BLACK)
270     {
271       if (node == node->parent->left)
272         {
273           GtkRBNode *w = node->parent->right;
274           if (GTK_RBNODE_GET_COLOR (w) == GTK_RBNODE_RED)
275             {
276               GTK_RBNODE_SET_COLOR (w, GTK_RBNODE_BLACK);
277               GTK_RBNODE_SET_COLOR (node->parent, GTK_RBNODE_RED);
278               _gtk_rbnode_rotate_left (tree, node->parent);
279               w = node->parent->right;
280             }
281           if (GTK_RBNODE_GET_COLOR (w->left) == GTK_RBNODE_BLACK && GTK_RBNODE_GET_COLOR (w->right) == GTK_RBNODE_BLACK)
282             {
283               GTK_RBNODE_SET_COLOR (w, GTK_RBNODE_RED);
284               node = node->parent;
285             }
286           else
287             {
288               if (GTK_RBNODE_GET_COLOR (w->right) == GTK_RBNODE_BLACK)
289                 {
290                   GTK_RBNODE_SET_COLOR (w->left, GTK_RBNODE_BLACK);
291                   GTK_RBNODE_SET_COLOR (w, GTK_RBNODE_RED);
292                   _gtk_rbnode_rotate_right (tree, w);
293                   w = node->parent->right;
294                 }
295               GTK_RBNODE_SET_COLOR (w, GTK_RBNODE_GET_COLOR (node->parent));
296               GTK_RBNODE_SET_COLOR (node->parent, GTK_RBNODE_BLACK);
297               GTK_RBNODE_SET_COLOR (w->right, GTK_RBNODE_BLACK);
298               _gtk_rbnode_rotate_left (tree, node->parent);
299               node = tree->root;
300             }
301         }
302       else
303         {
304           GtkRBNode *w = node->parent->left;
305           if (GTK_RBNODE_GET_COLOR (w) == GTK_RBNODE_RED)
306             {
307               GTK_RBNODE_SET_COLOR (w, GTK_RBNODE_BLACK);
308               GTK_RBNODE_SET_COLOR (node->parent, GTK_RBNODE_RED);
309               _gtk_rbnode_rotate_right (tree, node->parent);
310               w = node->parent->left;
311             }
312           if (GTK_RBNODE_GET_COLOR (w->right) == GTK_RBNODE_BLACK && GTK_RBNODE_GET_COLOR (w->left) == GTK_RBNODE_BLACK)
313             {
314               GTK_RBNODE_SET_COLOR (w, GTK_RBNODE_RED);
315               node = node->parent;
316             }
317           else
318             {
319               if (GTK_RBNODE_GET_COLOR (w->left) == GTK_RBNODE_BLACK)
320                 {
321                   GTK_RBNODE_SET_COLOR (w->right, GTK_RBNODE_BLACK);
322                   GTK_RBNODE_SET_COLOR (w, GTK_RBNODE_RED);
323                   _gtk_rbnode_rotate_left (tree, w);
324                   w = node->parent->left;
325                 }
326               GTK_RBNODE_SET_COLOR (w, GTK_RBNODE_GET_COLOR (node->parent));
327               GTK_RBNODE_SET_COLOR (node->parent, GTK_RBNODE_BLACK);
328               GTK_RBNODE_SET_COLOR (w->left, GTK_RBNODE_BLACK);
329               _gtk_rbnode_rotate_right (tree, node->parent);
330               node = tree->root;
331             }
332         }
333     }
334   GTK_RBNODE_SET_COLOR (node, GTK_RBNODE_BLACK);
335 }
336
337 GtkRBTree *
338 _gtk_rbtree_new (void)
339 {
340   GtkRBTree *retval;
341
342   retval = g_new (GtkRBTree, 1);
343   retval->parent_tree = NULL;
344   retval->parent_node = NULL;
345
346   retval->nil = g_slice_new (GtkRBNode);
347   retval->nil->left = NULL;
348   retval->nil->right = NULL;
349   retval->nil->parent = NULL;
350   retval->nil->flags = GTK_RBNODE_BLACK;
351   retval->nil->count = 0;
352   retval->nil->offset = 0;
353   retval->nil->total_count = 0;
354
355   retval->root = retval->nil;
356   return retval;
357 }
358
359 static void
360 _gtk_rbtree_free_helper (GtkRBTree  *tree,
361                          GtkRBNode  *node,
362                          gpointer    data)
363 {
364   if (node->children)
365     _gtk_rbtree_free (node->children);
366
367   _gtk_rbnode_free (node);
368 }
369
370 void
371 _gtk_rbtree_free (GtkRBTree *tree)
372 {
373   _gtk_rbtree_traverse (tree,
374                         tree->root,
375                         G_POST_ORDER,
376                         _gtk_rbtree_free_helper,
377                         NULL);
378
379   if (tree->parent_node &&
380       tree->parent_node->children == tree)
381     tree->parent_node->children = NULL;
382   _gtk_rbnode_free (tree->nil);
383   g_free (tree);
384 }
385
386 void
387 _gtk_rbtree_remove (GtkRBTree *tree)
388 {
389   GtkRBTree *tmp_tree;
390   GtkRBNode *tmp_node;
391
392   gint height = tree->root->offset;
393   guint total_count = tree->root->total_count;
394
395 #ifdef G_ENABLE_DEBUG  
396   if (gtk_get_debug_flags () & GTK_DEBUG_TREE)
397     _gtk_rbtree_test (G_STRLOC, tree);
398 #endif
399   
400   tmp_tree = tree->parent_tree;
401   tmp_node = tree->parent_node;
402
403   /* ugly hack to make _fixup_validation work in the first iteration of the
404    * loop below */
405   GTK_RBNODE_UNSET_FLAG (tree->root, GTK_RBNODE_DESCENDANTS_INVALID);
406   
407   while (tmp_tree && tmp_node && tmp_node != tmp_tree->nil)
408     {
409       _fixup_validation (tmp_tree, tmp_node);
410       tmp_node->offset -= height;
411       tmp_node->total_count -= total_count;
412       
413       tmp_node = tmp_node->parent;
414       if (tmp_node == tmp_tree->nil)
415         {
416           tmp_node = tmp_tree->parent_node;
417           tmp_tree = tmp_tree->parent_tree;
418         }
419     }
420
421   tmp_tree = tree->parent_tree;
422   tmp_node = tree->parent_node;
423   _gtk_rbtree_free (tree);
424
425 #ifdef G_ENABLE_DEBUG  
426   if (gtk_get_debug_flags () & GTK_DEBUG_TREE)
427     _gtk_rbtree_test (G_STRLOC, tmp_tree);
428 #endif
429 }
430
431
432 GtkRBNode *
433 _gtk_rbtree_insert_after (GtkRBTree *tree,
434                           GtkRBNode *current,
435                           gint       height,
436                           gboolean   valid)
437 {
438   GtkRBNode *node;
439   gboolean right = TRUE;
440   GtkRBNode *tmp_node;
441   GtkRBTree *tmp_tree;  
442
443 #ifdef G_ENABLE_DEBUG  
444   if (gtk_get_debug_flags () & GTK_DEBUG_TREE)
445     {
446       g_print ("\n\n_gtk_rbtree_insert_after: %p\n", current);
447       _gtk_rbtree_debug_spew (tree);
448       _gtk_rbtree_test (G_STRLOC, tree);
449     }
450 #endif /* G_ENABLE_DEBUG */  
451
452   if (current != NULL && current->right != tree->nil)
453     {
454       current = current->right;
455       while (current->left != tree->nil)
456         current = current->left;
457       right = FALSE;
458     }
459   /* setup new node */
460   node = _gtk_rbnode_new (tree, height);
461   node->parent = (current?current:tree->nil);
462
463   /* insert node in tree */
464   if (current)
465     {
466       if (right)
467         current->right = node;
468       else
469         current->left = node;
470       tmp_node = node->parent;
471       tmp_tree = tree;
472     }
473   else
474     {
475       g_assert (tree->root == tree->nil);
476       tree->root = node;
477       tmp_node = tree->parent_node;
478       tmp_tree = tree->parent_tree;
479     }
480
481   while (tmp_tree && tmp_node && tmp_node != tmp_tree->nil)
482     {
483       /* We only want to propagate the count if we are in the tree we
484        * started in. */
485       if (tmp_tree == tree)
486         tmp_node->count++;
487
488       tmp_node->total_count += 1;
489       tmp_node->offset += height;
490       tmp_node = tmp_node->parent;
491       if (tmp_node == tmp_tree->nil)
492         {
493           tmp_node = tmp_tree->parent_node;
494           tmp_tree = tmp_tree->parent_tree;
495         }
496     }
497
498   if (valid)
499     _gtk_rbtree_node_mark_valid (tree, node);
500   else
501     _gtk_rbtree_node_mark_invalid (tree, node);
502
503   _gtk_rbtree_insert_fixup (tree, node);
504
505 #ifdef G_ENABLE_DEBUG  
506   if (gtk_get_debug_flags () & GTK_DEBUG_TREE)
507     {
508       g_print ("_gtk_rbtree_insert_after finished...\n");
509       _gtk_rbtree_debug_spew (tree);
510       g_print ("\n\n");
511       _gtk_rbtree_test (G_STRLOC, tree);
512     }
513 #endif /* G_ENABLE_DEBUG */  
514
515   return node;
516 }
517
518 GtkRBNode *
519 _gtk_rbtree_insert_before (GtkRBTree *tree,
520                            GtkRBNode *current,
521                            gint       height,
522                            gboolean   valid)
523 {
524   GtkRBNode *node;
525   gboolean left = TRUE;
526   GtkRBNode *tmp_node;
527   GtkRBTree *tmp_tree;
528
529 #ifdef G_ENABLE_DEBUG  
530   if (gtk_get_debug_flags () & GTK_DEBUG_TREE)
531     {
532       g_print ("\n\n_gtk_rbtree_insert_before: %p\n", current);
533       _gtk_rbtree_debug_spew (tree);
534       _gtk_rbtree_test (G_STRLOC, tree);
535     }
536 #endif /* G_ENABLE_DEBUG */
537   
538   if (current != NULL && current->left != tree->nil)
539     {
540       current = current->left;
541       while (current->right != tree->nil)
542         current = current->right;
543       left = FALSE;
544     }
545
546   /* setup new node */
547   node = _gtk_rbnode_new (tree, height);
548   node->parent = (current?current:tree->nil);
549
550   /* insert node in tree */
551   if (current)
552     {
553       if (left)
554         current->left = node;
555       else
556         current->right = node;
557       tmp_node = node->parent;
558       tmp_tree = tree;
559     }
560   else
561     {
562       g_assert (tree->root == tree->nil);
563       tree->root = node;
564       tmp_node = tree->parent_node;
565       tmp_tree = tree->parent_tree;
566     }
567
568   while (tmp_tree && tmp_node && tmp_node != tmp_tree->nil)
569     {
570       /* We only want to propagate the count if we are in the tree we
571        * started in. */
572       if (tmp_tree == tree)
573         tmp_node->count++;
574
575       tmp_node->total_count += 1;
576       tmp_node->offset += height;
577       tmp_node = tmp_node->parent;
578       if (tmp_node == tmp_tree->nil)
579         {
580           tmp_node = tmp_tree->parent_node;
581           tmp_tree = tmp_tree->parent_tree;
582         }
583     }
584
585   if (valid)
586     _gtk_rbtree_node_mark_valid (tree, node);
587   else
588     _gtk_rbtree_node_mark_invalid (tree, node);
589
590   _gtk_rbtree_insert_fixup (tree, node);
591
592 #ifdef G_ENABLE_DEBUG  
593   if (gtk_get_debug_flags () & GTK_DEBUG_TREE)
594     {
595       g_print ("_gtk_rbtree_insert_before finished...\n");
596       _gtk_rbtree_debug_spew (tree);
597       g_print ("\n\n");
598       _gtk_rbtree_test (G_STRLOC, tree);
599     }
600 #endif /* G_ENABLE_DEBUG */
601   
602   return node;
603 }
604
605 GtkRBNode *
606 _gtk_rbtree_find_count (GtkRBTree *tree,
607                         gint       count)
608 {
609   GtkRBNode *node;
610
611   node = tree->root;
612   while (node != tree->nil && (node->left->count + 1 != count))
613     {
614       if (node->left->count >= count)
615         node = node->left;
616       else
617         {
618           count -= (node->left->count + 1);
619           node = node->right;
620         }
621     }
622   if (node == tree->nil)
623     return NULL;
624   return node;
625 }
626
627 void
628 _gtk_rbtree_node_set_height (GtkRBTree *tree,
629                              GtkRBNode *node,
630                              gint       height)
631 {
632   gint diff = height - GTK_RBNODE_GET_HEIGHT (node);
633   GtkRBNode *tmp_node = node;
634   GtkRBTree *tmp_tree = tree;
635
636   if (diff == 0)
637     return;
638
639   while (tmp_tree && tmp_node && tmp_node != tmp_tree->nil)
640     {
641       tmp_node->offset += diff;
642       tmp_node = tmp_node->parent;
643       if (tmp_node == tmp_tree->nil)
644         {
645           tmp_node = tmp_tree->parent_node;
646           tmp_tree = tmp_tree->parent_tree;
647         }
648     }
649 #ifdef G_ENABLE_DEBUG  
650   if (gtk_get_debug_flags () & GTK_DEBUG_TREE)
651     _gtk_rbtree_test (G_STRLOC, tree);
652 #endif
653 }
654
655 void
656 _gtk_rbtree_node_mark_invalid (GtkRBTree *tree,
657                                GtkRBNode *node)
658 {
659   if (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_INVALID))
660     return;
661
662   GTK_RBNODE_SET_FLAG (node, GTK_RBNODE_INVALID);
663   do
664     {
665       if (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_DESCENDANTS_INVALID))
666         return;
667       GTK_RBNODE_SET_FLAG (node, GTK_RBNODE_DESCENDANTS_INVALID);
668       node = node->parent;
669       if (node == tree->nil)
670         {
671           node = tree->parent_node;
672           tree = tree->parent_tree;
673         }
674     }
675   while (node);
676 }
677
678 #if 0
679 /* Draconian version. */
680 void
681 _gtk_rbtree_node_mark_invalid (GtkRBTree *tree,
682                                GtkRBNode *node)
683 {
684   GTK_RBNODE_SET_FLAG (node, GTK_RBNODE_INVALID);
685   do
686     {
687       _fixup_validation (tree, node);
688       node = node->parent;
689       if (node == tree->nil)
690         {
691           node = tree->parent_node;
692           tree = tree->parent_tree;
693         }
694     }
695   while (node);
696 }
697 #endif
698
699 void
700 _gtk_rbtree_node_mark_valid (GtkRBTree *tree,
701                              GtkRBNode *node)
702 {
703   if ((!GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_INVALID)) &&
704       (!GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_COLUMN_INVALID)))
705     return;
706
707   GTK_RBNODE_UNSET_FLAG (node, GTK_RBNODE_INVALID);
708   GTK_RBNODE_UNSET_FLAG (node, GTK_RBNODE_COLUMN_INVALID);
709
710   do
711     {
712       if ((GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_INVALID)) ||
713           (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_COLUMN_INVALID)) ||
714           (node->children && GTK_RBNODE_FLAG_SET (node->children->root, GTK_RBNODE_DESCENDANTS_INVALID)) ||
715           (node->left != tree->nil && GTK_RBNODE_FLAG_SET (node->left, GTK_RBNODE_DESCENDANTS_INVALID)) ||
716           (node->right != tree->nil && GTK_RBNODE_FLAG_SET (node->right, GTK_RBNODE_DESCENDANTS_INVALID)))
717         return;
718
719       GTK_RBNODE_UNSET_FLAG (node, GTK_RBNODE_DESCENDANTS_INVALID);
720       node = node->parent;
721       if (node == tree->nil)
722         {
723           node = tree->parent_node;
724           tree = tree->parent_tree;
725         }
726     }
727   while (node);
728 }
729
730 #if 0
731 /* Draconian version */
732 void
733 _gtk_rbtree_node_mark_valid (GtkRBTree *tree,
734                              GtkRBNode *node)
735 {
736   GTK_RBNODE_UNSET_FLAG (node, GTK_RBNODE_INVALID);
737   GTK_RBNODE_UNSET_FLAG (node, GTK_RBNODE_COLUMN_INVALID);
738
739   do
740     {
741       _fixup_validation (tree, node);
742       node = node->parent;
743       if (node == tree->nil)
744         {
745           node = tree->parent_node;
746           tree = tree->parent_tree;
747         }
748     }
749   while (node);
750 }
751 #endif
752 /* Assume tree is the root node as it doesn't set DESCENDANTS_INVALID above.
753  */
754 void
755 _gtk_rbtree_column_invalid (GtkRBTree *tree)
756 {
757   GtkRBNode *node;
758
759   if (tree == NULL)
760     return;
761   node = tree->root;
762   g_assert (node);
763
764   while (node->left != tree->nil)
765     node = node->left;
766
767   do
768     {
769       if (! (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_INVALID)))
770         GTK_RBNODE_SET_FLAG (node, GTK_RBNODE_COLUMN_INVALID);
771       GTK_RBNODE_SET_FLAG (node, GTK_RBNODE_DESCENDANTS_INVALID);
772
773       if (node->children)
774         _gtk_rbtree_column_invalid (node->children);
775     }
776   while ((node = _gtk_rbtree_next (tree, node)) != NULL);
777 }
778
779 void
780 _gtk_rbtree_mark_invalid (GtkRBTree *tree)
781 {
782   GtkRBNode *node;
783
784   if (tree == NULL)
785     return;
786   node = tree->root;
787   g_assert (node);
788
789   while (node->left != tree->nil)
790     node = node->left;
791
792   do
793     {
794       GTK_RBNODE_SET_FLAG (node, GTK_RBNODE_INVALID);
795       GTK_RBNODE_SET_FLAG (node, GTK_RBNODE_DESCENDANTS_INVALID);
796
797       if (node->children)
798         _gtk_rbtree_mark_invalid (node->children);
799     }
800   while ((node = _gtk_rbtree_next (tree, node)) != NULL);
801 }
802
803 void
804 _gtk_rbtree_set_fixed_height (GtkRBTree *tree,
805                               gint       height,
806                               gboolean   mark_valid)
807 {
808   GtkRBNode *node;
809
810   if (tree == NULL)
811     return;
812
813   node = tree->root;
814   g_assert (node);
815
816   while (node->left != tree->nil)
817     node = node->left;
818
819   do
820     {
821       if (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_INVALID))
822         {
823           _gtk_rbtree_node_set_height (tree, node, height);
824           if (mark_valid)
825             _gtk_rbtree_node_mark_valid (tree, node);
826         }
827
828       if (node->children)
829         _gtk_rbtree_set_fixed_height (node->children, height, mark_valid);
830     }
831   while ((node = _gtk_rbtree_next (tree, node)) != NULL);
832 }
833
834 typedef struct _GtkRBReorder
835 {
836   GtkRBTree *children;
837   gint height;
838   gint flags;
839   gint order;
840   gint invert_order;
841   guint total_count;
842 } GtkRBReorder;
843
844 static int
845 gtk_rbtree_reorder_sort_func (gconstpointer a,
846                               gconstpointer b)
847 {
848   return ((GtkRBReorder *) a)->order - ((GtkRBReorder *) b)->order;
849 }
850
851 static int
852 gtk_rbtree_reorder_invert_func (gconstpointer a,
853                                 gconstpointer b)
854 {
855   return ((GtkRBReorder *) a)->invert_order - ((GtkRBReorder *) b)->invert_order;
856 }
857
858 static void
859 gtk_rbtree_reorder_fixup (GtkRBTree *tree,
860                           GtkRBNode *node)
861 {
862   if (node == tree->nil)
863     return;
864
865   node->total_count = 1;
866
867   if (node->left != tree->nil)
868     {
869       gtk_rbtree_reorder_fixup (tree, node->left);
870       node->offset += node->left->offset;
871       node->total_count += node->left->total_count;
872     }
873   if (node->right != tree->nil)
874     {
875       gtk_rbtree_reorder_fixup (tree, node->right);
876       node->offset += node->right->offset;
877       node->total_count += node->right->total_count;
878     }
879       
880   if (node->children)
881     {
882       node->offset += node->children->root->offset;
883       node->total_count += node->children->root->total_count;
884     }
885   
886   if (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_INVALID) ||
887       (node->right != tree->nil && GTK_RBNODE_FLAG_SET (node->right, GTK_RBNODE_DESCENDANTS_INVALID)) ||
888       (node->left != tree->nil && GTK_RBNODE_FLAG_SET (node->left, GTK_RBNODE_DESCENDANTS_INVALID)) ||
889       (node->children && GTK_RBNODE_FLAG_SET (node->children->root, GTK_RBNODE_DESCENDANTS_INVALID)))
890     GTK_RBNODE_SET_FLAG (node, GTK_RBNODE_DESCENDANTS_INVALID);
891   else
892     GTK_RBNODE_UNSET_FLAG (node, GTK_RBNODE_DESCENDANTS_INVALID);
893 }
894
895 /* It basically pulls everything out of the tree, rearranges it, and puts it
896  * back together.  Our strategy is to keep the old RBTree intact, and just
897  * rearrange the contents.  When that is done, we go through and update the
898  * heights.  There is probably a more elegant way to write this function.  If
899  * anyone wants to spend the time writing it, patches will be accepted.
900  */
901 void
902 _gtk_rbtree_reorder (GtkRBTree *tree,
903                      gint      *new_order,
904                      gint       length)
905 {
906   GtkRBReorder reorder = { NULL };
907   GArray *array;
908   GtkRBNode *node;
909   gint i;
910   
911   g_return_if_fail (tree != NULL);
912   g_return_if_fail (length > 0);
913   g_return_if_fail (tree->root->count == length);
914   
915   /* Sort the trees values in the new tree. */
916   array = g_array_sized_new (FALSE, FALSE, sizeof (GtkRBReorder), length);
917   for (i = 0; i < length; i++)
918     {
919       reorder.order = new_order[i];
920       reorder.invert_order = i;
921       g_array_append_val (array, reorder);
922     }
923
924   g_array_sort(array, gtk_rbtree_reorder_sort_func);
925
926   /* rewind node*/
927   node = tree->root;
928   while (node && node->left != tree->nil)
929     node = node->left;
930
931   for (i = 0; i < length; i++)
932     {
933       g_assert (node != tree->nil);
934       g_array_index (array, GtkRBReorder, i).children = node->children;
935       g_array_index (array, GtkRBReorder, i).flags = GTK_RBNODE_NON_COLORS & node->flags;
936       g_array_index (array, GtkRBReorder, i).height = GTK_RBNODE_GET_HEIGHT (node);
937
938       node = _gtk_rbtree_next (tree, node);
939     }
940
941   g_array_sort (array, gtk_rbtree_reorder_invert_func);
942  
943   /* rewind node*/
944   node = tree->root;
945   while (node && node->left != tree->nil)
946     node = node->left;
947
948   /* Go through the tree and change the values to the new ones. */
949   for (i = 0; i < length; i++)
950     {
951       reorder = g_array_index (array, GtkRBReorder, i);
952       node->children = reorder.children;
953       if (node->children)
954         node->children->parent_node = node;
955       node->flags = GTK_RBNODE_GET_COLOR (node) | reorder.flags;
956       /* We temporarily set the height to this. */
957       node->offset = reorder.height;
958       node = _gtk_rbtree_next (tree, node);
959     }
960   gtk_rbtree_reorder_fixup (tree, tree->root);
961
962   g_array_free (array, TRUE);
963 }
964
965
966 gint
967 _gtk_rbtree_node_find_offset (GtkRBTree *tree,
968                               GtkRBNode *node)
969 {
970   GtkRBNode *last;
971   gint retval;
972
973   g_assert (node);
974   g_assert (node->left);
975   
976   retval = node->left->offset;
977
978   while (tree && node && node != tree->nil)
979     {
980       last = node;
981       node = node->parent;
982
983       /* Add left branch, plus children, iff we came from the right */
984       if (node->right == last)
985         retval += node->offset - node->right->offset;
986       
987       if (node == tree->nil)
988         {
989           node = tree->parent_node;
990           tree = tree->parent_tree;
991
992           /* Add the parent node, plus the left branch. */
993           if (node)
994             retval += node->left->offset + GTK_RBNODE_GET_HEIGHT (node);
995         }
996     }
997   return retval;
998 }
999
1000 guint
1001 _gtk_rbtree_node_get_index (GtkRBTree *tree,
1002                             GtkRBNode *node)
1003 {
1004   GtkRBNode *last;
1005   guint retval;  
1006   
1007   g_assert (node);
1008   g_assert (node->left);
1009   
1010   retval = node->left->total_count;
1011
1012   while (tree && node && node != tree->nil)
1013     {
1014       last = node;
1015       node = node->parent;
1016
1017       /* Add left branch, plus children, iff we came from the right */
1018       if (node->right == last)
1019         retval += node->total_count - node->right->total_count;
1020       
1021       if (node == tree->nil)
1022         {
1023           node = tree->parent_node;
1024           tree = tree->parent_tree;
1025
1026           /* Add the parent node, plus the left branch. */
1027           if (node)
1028             retval += node->left->total_count + 1; /* 1 == GTK_RBNODE_GET_PARITY() */
1029         }
1030     }
1031   
1032   return retval;
1033 }
1034
1035 gint
1036 _gtk_rbtree_real_find_offset (GtkRBTree  *tree,
1037                               gint        height,
1038                               GtkRBTree **new_tree,
1039                               GtkRBNode **new_node)
1040 {
1041   GtkRBNode *tmp_node;
1042
1043   g_assert (tree);
1044
1045   if (height < 0)
1046     {
1047       *new_tree = NULL;
1048       *new_node = NULL;
1049
1050       return 0;
1051     }
1052   
1053     
1054   tmp_node = tree->root;
1055   while (tmp_node != tree->nil &&
1056          (tmp_node->left->offset > height ||
1057           (tmp_node->offset - tmp_node->right->offset) < height))
1058     {
1059       if (tmp_node->left->offset > height)
1060         tmp_node = tmp_node->left;
1061       else
1062         {
1063           height -= (tmp_node->offset - tmp_node->right->offset);
1064           tmp_node = tmp_node->right;
1065         }
1066     }
1067   if (tmp_node == tree->nil)
1068     {
1069       *new_tree = NULL;
1070       *new_node = NULL;
1071       return 0;
1072     }
1073   if (tmp_node->children)
1074     {
1075       if ((tmp_node->offset -
1076            tmp_node->right->offset -
1077            tmp_node->children->root->offset) > height)
1078         {
1079           *new_tree = tree;
1080           *new_node = tmp_node;
1081           return (height - tmp_node->left->offset);
1082         }
1083       return _gtk_rbtree_real_find_offset (tmp_node->children,
1084                                            height - tmp_node->left->offset -
1085                                            (tmp_node->offset -
1086                                             tmp_node->left->offset -
1087                                             tmp_node->right->offset -
1088                                             tmp_node->children->root->offset),
1089                                            new_tree,
1090                                            new_node);
1091     }
1092   *new_tree = tree;
1093   *new_node = tmp_node;
1094   return (height - tmp_node->left->offset);
1095 }
1096
1097 gint
1098 _gtk_rbtree_find_offset (GtkRBTree  *tree,
1099                               gint        height,
1100                               GtkRBTree **new_tree,
1101                               GtkRBNode **new_node)
1102 {
1103   g_assert (tree);
1104
1105   if ((height < 0) ||
1106       (height >= tree->root->offset))
1107     {
1108       *new_tree = NULL;
1109       *new_node = NULL;
1110
1111       return 0;
1112     }
1113   return _gtk_rbtree_real_find_offset (tree, height, new_tree, new_node);
1114 }
1115
1116 gboolean
1117 _gtk_rbtree_find_index (GtkRBTree  *tree,
1118                         guint       index,
1119                         GtkRBTree **new_tree,
1120                         GtkRBNode **new_node)
1121 {
1122   GtkRBNode *tmp_node;
1123
1124   g_assert (tree);
1125
1126   tmp_node = tree->root;
1127   while (tmp_node != tree->nil)
1128     {
1129       if (tmp_node->left->total_count > index)
1130         {
1131           tmp_node = tmp_node->left;
1132         }
1133       else if (tmp_node->total_count - tmp_node->right->total_count <= index)
1134         {
1135           index -= tmp_node->total_count - tmp_node->right->total_count;
1136           tmp_node = tmp_node->right;
1137         }
1138       else
1139         {
1140           index -= tmp_node->left->total_count;
1141           break;
1142         }
1143     }
1144   if (tmp_node == tree->nil)
1145     {
1146       *new_tree = NULL;
1147       *new_node = NULL;
1148       return FALSE;
1149     }
1150
1151   if (index > 0)
1152     {
1153       g_assert (tmp_node->children);
1154
1155       return _gtk_rbtree_find_index (tmp_node->children,
1156                                      index - 1,
1157                                      new_tree,
1158                                      new_node);
1159     }
1160
1161   *new_tree = tree;
1162   *new_node = tmp_node;
1163   return TRUE;
1164 }
1165
1166 void
1167 _gtk_rbtree_remove_node (GtkRBTree *tree,
1168                          GtkRBNode *node)
1169 {
1170   GtkRBNode *x, *y;
1171   GtkRBTree *tmp_tree;
1172   GtkRBNode *tmp_node;
1173   gint y_height;
1174   
1175   g_return_if_fail (tree != NULL);
1176   g_return_if_fail (node != NULL);
1177
1178   
1179 #ifdef G_ENABLE_DEBUG
1180   if (gtk_get_debug_flags () & GTK_DEBUG_TREE)
1181     {
1182       g_print ("\n\n_gtk_rbtree_remove_node: %p\n", node);
1183       _gtk_rbtree_debug_spew (tree);
1184       _gtk_rbtree_test (G_STRLOC, tree);
1185     }
1186 #endif /* G_ENABLE_DEBUG */
1187   
1188   /* make sure we're deleting a node that's actually in the tree */
1189   for (x = node; x->parent != tree->nil; x = x->parent)
1190     ;
1191   g_return_if_fail (x == tree->root);
1192
1193 #ifdef G_ENABLE_DEBUG  
1194   if (gtk_get_debug_flags () & GTK_DEBUG_TREE)
1195     _gtk_rbtree_test (G_STRLOC, tree);
1196 #endif
1197   
1198   if (node->left == tree->nil || node->right == tree->nil)
1199     {
1200       y = node;
1201     }
1202   else
1203     {
1204       y = node->right;
1205
1206       while (y->left != tree->nil)
1207         y = y->left;
1208     }
1209
1210   /* adjust count only beneath tree */
1211   for (x = y; x != tree->nil; x = x->parent)
1212     {
1213       x->count--;
1214     }
1215
1216   /* offsets and total count adjust all the way up through parent trees */
1217   y_height = GTK_RBNODE_GET_HEIGHT (y);
1218
1219   tmp_tree = tree;
1220   tmp_node = y;
1221   while (tmp_tree && tmp_node && tmp_node != tmp_tree->nil)
1222     {
1223       tmp_node->offset -= (y_height + (y->children?y->children->root->offset:0));
1224       _fixup_validation (tmp_tree, tmp_node);
1225       _fixup_total_count (tmp_tree, tmp_node);
1226       tmp_node = tmp_node->parent;
1227       if (tmp_node == tmp_tree->nil)
1228         {
1229           tmp_node = tmp_tree->parent_node;
1230           tmp_tree = tmp_tree->parent_tree;
1231         }
1232     }
1233
1234   /* x is y's only child, or nil */
1235   if (y->left != tree->nil)
1236     x = y->left;
1237   else
1238     x = y->right;
1239
1240   /* remove y from the parent chain */
1241   x->parent = y->parent;
1242   if (y->parent != tree->nil)
1243     {
1244       if (y == y->parent->left)
1245         y->parent->left = x;
1246       else
1247         y->parent->right = x;
1248     }
1249   else
1250     {
1251       tree->root = x;
1252     }
1253
1254   /* We need to clean up the validity of the tree.
1255    */
1256
1257   tmp_tree = tree;
1258   tmp_node = x;
1259   do
1260     {
1261       /* We skip the first time, iff x is nil */
1262       if (tmp_node != tmp_tree->nil)
1263         {
1264           _fixup_validation (tmp_tree, tmp_node);
1265           _fixup_total_count (tmp_tree, tmp_node);
1266         }
1267       tmp_node = tmp_node->parent;
1268       if (tmp_node == tmp_tree->nil)
1269         {
1270           tmp_node = tmp_tree->parent_node;
1271           tmp_tree = tmp_tree->parent_tree;
1272         }
1273     }
1274   while (tmp_tree != NULL);
1275
1276   if (y != node)
1277     {
1278       gint diff;
1279
1280       /* Copy the node over */
1281       if (GTK_RBNODE_GET_COLOR (node) == GTK_RBNODE_BLACK)
1282         node->flags = ((y->flags & (GTK_RBNODE_NON_COLORS)) | GTK_RBNODE_BLACK);
1283       else
1284         node->flags = ((y->flags & (GTK_RBNODE_NON_COLORS)) | GTK_RBNODE_RED);
1285       node->children = y->children;
1286       if (y->children)
1287         {
1288           node->children = y->children;
1289           node->children->parent_node = node;
1290         }
1291       else
1292         {
1293           node->children = NULL;
1294         }
1295       _fixup_validation (tree, node);
1296       _fixup_total_count (tree, node);
1297       /* We want to see how different our height is from the previous node.
1298        * To do this, we compare our current height with our supposed height.
1299        */
1300       diff = y_height - GTK_RBNODE_GET_HEIGHT (node);
1301       tmp_tree = tree;
1302       tmp_node = node;
1303
1304       while (tmp_tree && tmp_node && tmp_node != tmp_tree->nil)
1305         {
1306           tmp_node->offset += diff;
1307           _fixup_validation (tmp_tree, tmp_node);
1308           _fixup_total_count (tmp_tree, tmp_node);
1309           tmp_node = tmp_node->parent;
1310           if (tmp_node == tmp_tree->nil)
1311             {
1312               tmp_node = tmp_tree->parent_node;
1313               tmp_tree = tmp_tree->parent_tree;
1314             }
1315         }
1316     }
1317
1318   if (GTK_RBNODE_GET_COLOR (y) == GTK_RBNODE_BLACK)
1319     _gtk_rbtree_remove_node_fixup (tree, x);
1320   _gtk_rbnode_free (y);
1321
1322 #ifdef G_ENABLE_DEBUG  
1323   if (gtk_get_debug_flags () & GTK_DEBUG_TREE)
1324     {
1325       g_print ("_gtk_rbtree_remove_node finished...\n");
1326       _gtk_rbtree_debug_spew (tree);
1327       g_print ("\n\n");
1328       _gtk_rbtree_test (G_STRLOC, tree);
1329     }
1330 #endif /* G_ENABLE_DEBUG */  
1331 }
1332
1333 GtkRBNode *
1334 _gtk_rbtree_next (GtkRBTree *tree,
1335                   GtkRBNode *node)
1336 {
1337   g_return_val_if_fail (tree != NULL, NULL);
1338   g_return_val_if_fail (node != NULL, NULL);
1339
1340   /* Case 1: the node's below us. */
1341   if (node->right != tree->nil)
1342     {
1343       node = node->right;
1344       while (node->left != tree->nil)
1345         node = node->left;
1346       return node;
1347     }
1348
1349   /* Case 2: it's an ancestor */
1350   while (node->parent != tree->nil)
1351     {
1352       if (node->parent->right == node)
1353         node = node->parent;
1354       else
1355         return (node->parent);
1356     }
1357
1358   /* Case 3: There is no next node */
1359   return NULL;
1360 }
1361
1362 GtkRBNode *
1363 _gtk_rbtree_prev (GtkRBTree *tree,
1364                   GtkRBNode *node)
1365 {
1366   g_return_val_if_fail (tree != NULL, NULL);
1367   g_return_val_if_fail (node != NULL, NULL);
1368
1369   /* Case 1: the node's below us. */
1370   if (node->left != tree->nil)
1371     {
1372       node = node->left;
1373       while (node->right != tree->nil)
1374         node = node->right;
1375       return node;
1376     }
1377
1378   /* Case 2: it's an ancestor */
1379   while (node->parent != tree->nil)
1380     {
1381       if (node->parent->left == node)
1382         node = node->parent;
1383       else
1384         return (node->parent);
1385     }
1386
1387   /* Case 3: There is no next node */
1388   return NULL;
1389 }
1390
1391 void
1392 _gtk_rbtree_next_full (GtkRBTree  *tree,
1393                        GtkRBNode  *node,
1394                        GtkRBTree **new_tree,
1395                        GtkRBNode **new_node)
1396 {
1397   g_return_if_fail (tree != NULL);
1398   g_return_if_fail (node != NULL);
1399   g_return_if_fail (new_tree != NULL);
1400   g_return_if_fail (new_node != NULL);
1401
1402   if (node->children)
1403     {
1404       *new_tree = node->children;
1405       *new_node = (*new_tree)->root;
1406       while ((*new_node)->left != (*new_tree)->nil)
1407         *new_node = (*new_node)->left;
1408       return;
1409     }
1410
1411   *new_tree = tree;
1412   *new_node = _gtk_rbtree_next (tree, node);
1413
1414   while ((*new_node == NULL) &&
1415          (*new_tree != NULL))
1416     {
1417       *new_node = (*new_tree)->parent_node;
1418       *new_tree = (*new_tree)->parent_tree;
1419       if (*new_tree)
1420         *new_node = _gtk_rbtree_next (*new_tree, *new_node);
1421     }
1422 }
1423
1424 void
1425 _gtk_rbtree_prev_full (GtkRBTree  *tree,
1426                        GtkRBNode  *node,
1427                        GtkRBTree **new_tree,
1428                        GtkRBNode **new_node)
1429 {
1430   g_return_if_fail (tree != NULL);
1431   g_return_if_fail (node != NULL);
1432   g_return_if_fail (new_tree != NULL);
1433   g_return_if_fail (new_node != NULL);
1434
1435   *new_tree = tree;
1436   *new_node = _gtk_rbtree_prev (tree, node);
1437
1438   if (*new_node == NULL)
1439     {
1440       *new_node = (*new_tree)->parent_node;
1441       *new_tree = (*new_tree)->parent_tree;
1442     }
1443   else
1444     {
1445       while ((*new_node)->children)
1446         {
1447           *new_tree = (*new_node)->children;
1448           *new_node = (*new_tree)->root;
1449           while ((*new_node)->right != (*new_tree)->nil)
1450             *new_node = (*new_node)->right;
1451         }
1452     }
1453 }
1454
1455 gint
1456 _gtk_rbtree_get_depth (GtkRBTree *tree)
1457 {
1458   GtkRBTree *tmp_tree;
1459   gint depth = 0;
1460
1461   tmp_tree = tree->parent_tree;
1462   while (tmp_tree)
1463     {
1464       ++depth;
1465       tmp_tree = tmp_tree->parent_tree;
1466     }
1467
1468   return depth;
1469 }
1470
1471 static void
1472 _gtk_rbtree_traverse_pre_order (GtkRBTree             *tree,
1473                                 GtkRBNode             *node,
1474                                 GtkRBTreeTraverseFunc  func,
1475                                 gpointer               data)
1476 {
1477   if (node == tree->nil)
1478     return;
1479
1480   (* func) (tree, node, data);
1481   _gtk_rbtree_traverse_pre_order (tree, node->left, func, data);
1482   _gtk_rbtree_traverse_pre_order (tree, node->right, func, data);
1483 }
1484
1485 static void
1486 _gtk_rbtree_traverse_post_order (GtkRBTree             *tree,
1487                                  GtkRBNode             *node,
1488                                  GtkRBTreeTraverseFunc  func,
1489                                  gpointer               data)
1490 {
1491   if (node == tree->nil)
1492     return;
1493
1494   _gtk_rbtree_traverse_post_order (tree, node->left, func, data);
1495   _gtk_rbtree_traverse_post_order (tree, node->right, func, data);
1496   (* func) (tree, node, data);
1497 }
1498
1499 void
1500 _gtk_rbtree_traverse (GtkRBTree             *tree,
1501                       GtkRBNode             *node,
1502                       GTraverseType          order,
1503                       GtkRBTreeTraverseFunc  func,
1504                       gpointer               data)
1505 {
1506   g_return_if_fail (tree != NULL);
1507   g_return_if_fail (node != NULL);
1508   g_return_if_fail (func != NULL);
1509   g_return_if_fail (order <= G_LEVEL_ORDER);
1510
1511   switch (order)
1512     {
1513     case G_PRE_ORDER:
1514       _gtk_rbtree_traverse_pre_order (tree, node, func, data);
1515       break;
1516     case G_POST_ORDER:
1517       _gtk_rbtree_traverse_post_order (tree, node, func, data);
1518       break;
1519     case G_IN_ORDER:
1520     case G_LEVEL_ORDER:
1521     default:
1522       g_warning ("unsupported traversal order.");
1523       break;
1524     }
1525 }
1526
1527 static inline
1528 void _fixup_validation (GtkRBTree *tree,
1529                         GtkRBNode *node)
1530 {
1531   if (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_INVALID) ||
1532       GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_COLUMN_INVALID) ||
1533       (node->left != tree->nil && GTK_RBNODE_FLAG_SET (node->left, GTK_RBNODE_DESCENDANTS_INVALID)) ||
1534       (node->right != tree->nil && GTK_RBNODE_FLAG_SET (node->right, GTK_RBNODE_DESCENDANTS_INVALID)) ||
1535       (node->children != NULL && GTK_RBNODE_FLAG_SET (node->children->root, GTK_RBNODE_DESCENDANTS_INVALID)))
1536     {
1537       GTK_RBNODE_SET_FLAG (node, GTK_RBNODE_DESCENDANTS_INVALID);
1538     }
1539   else
1540     {
1541       GTK_RBNODE_UNSET_FLAG (node, GTK_RBNODE_DESCENDANTS_INVALID);
1542     }
1543 }
1544
1545 static inline
1546 void _fixup_total_count (GtkRBTree *tree,
1547                     GtkRBNode *node)
1548 {
1549   node->total_count = 1 +
1550     (node->children != NULL ? node->children->root->total_count : 0) + 
1551     node->left->total_count + node->right->total_count;
1552 }
1553
1554 #ifdef G_ENABLE_DEBUG
1555 static guint
1556 get_total_count (GtkRBNode *node)
1557 {
1558   guint child_total = 0;
1559
1560   child_total += (guint) node->left->total_count;
1561   child_total += (guint) node->right->total_count;
1562
1563   if (node->children)
1564     child_total += (guint) node->children->root->total_count;
1565
1566   return child_total + 1;
1567 }
1568
1569 static guint
1570 count_total (GtkRBTree *tree,
1571              GtkRBNode *node)
1572 {
1573   guint res;
1574   
1575   if (node == tree->nil)
1576     return 0;
1577   
1578   res =
1579     count_total (tree, node->left) +
1580     count_total (tree, node->right) +
1581     (guint)1 +
1582     (node->children ? count_total (node->children, node->children->root) : 0);
1583
1584   if (res != node->total_count)
1585     g_print ("total count incorrect for node\n");
1586
1587   if (get_total_count (node) != node->total_count)
1588     g_error ("Node has incorrect total count %u, should be %u", node->total_count, get_total_count (node));
1589   
1590   return res;
1591 }
1592
1593 static gint
1594 _count_nodes (GtkRBTree *tree,
1595               GtkRBNode *node)
1596 {
1597   gint res;
1598   if (node == tree->nil)
1599     return 0;
1600
1601   g_assert (node->left);
1602   g_assert (node->right);
1603
1604   res = (_count_nodes (tree, node->left) +
1605          _count_nodes (tree, node->right) + 1);
1606
1607   if (res != node->count)
1608     g_print ("Tree failed\n");
1609   return res;
1610 }
1611
1612 static void
1613 _gtk_rbtree_test_height (GtkRBTree *tree,
1614                          GtkRBNode *node)
1615 {
1616   gint computed_offset = 0;
1617
1618   /* This whole test is sort of a useless truism. */
1619   
1620   if (node->left != tree->nil)
1621     computed_offset += node->left->offset;
1622
1623   if (node->right != tree->nil)
1624     computed_offset += node->right->offset;
1625
1626   if (node->children && node->children->root != node->children->nil)
1627     computed_offset += node->children->root->offset;
1628
1629   if (GTK_RBNODE_GET_HEIGHT (node) + computed_offset != node->offset)
1630     g_error ("node has broken offset\n");
1631
1632   if (node->left != tree->nil)
1633     _gtk_rbtree_test_height (tree, node->left);
1634
1635   if (node->right != tree->nil)
1636     _gtk_rbtree_test_height (tree, node->right);
1637
1638   if (node->children && node->children->root != node->children->nil)
1639     _gtk_rbtree_test_height (node->children, node->children->root);
1640 }
1641
1642 static void
1643 _gtk_rbtree_test_dirty (GtkRBTree *tree,
1644                         GtkRBNode *node,
1645                          gint      expected_dirtyness)
1646 {
1647
1648   if (expected_dirtyness)
1649     {
1650       g_assert (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_COLUMN_INVALID) ||
1651                 GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_INVALID) ||
1652                 (node->left != tree->nil && GTK_RBNODE_FLAG_SET (node->left, GTK_RBNODE_DESCENDANTS_INVALID)) ||
1653                 (node->right != tree->nil && GTK_RBNODE_FLAG_SET (node->right, GTK_RBNODE_DESCENDANTS_INVALID)) ||
1654                 (node->children && GTK_RBNODE_FLAG_SET (node->children->root, GTK_RBNODE_DESCENDANTS_INVALID)));
1655     }
1656   else
1657     {
1658       g_assert (! GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_COLUMN_INVALID) &&
1659                 ! GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_INVALID));
1660       if (node->left != tree->nil)
1661         g_assert (! GTK_RBNODE_FLAG_SET (node->left, GTK_RBNODE_DESCENDANTS_INVALID));
1662       if (node->right != tree->nil)
1663         g_assert (! GTK_RBNODE_FLAG_SET (node->right, GTK_RBNODE_DESCENDANTS_INVALID));
1664       if (node->children != NULL)
1665         g_assert (! GTK_RBNODE_FLAG_SET (node->children->root, GTK_RBNODE_DESCENDANTS_INVALID));
1666     }
1667
1668   if (node->left != tree->nil)
1669     _gtk_rbtree_test_dirty (tree, node->left, GTK_RBNODE_FLAG_SET (node->left, GTK_RBNODE_DESCENDANTS_INVALID));
1670   if (node->right != tree->nil)
1671     _gtk_rbtree_test_dirty (tree, node->right, GTK_RBNODE_FLAG_SET (node->right, GTK_RBNODE_DESCENDANTS_INVALID));
1672   if (node->children != NULL && node->children->root != node->children->nil)
1673     _gtk_rbtree_test_dirty (node->children, node->children->root, GTK_RBNODE_FLAG_SET (node->children->root, GTK_RBNODE_DESCENDANTS_INVALID));
1674 }
1675
1676 static void _gtk_rbtree_test_structure (GtkRBTree *tree);
1677
1678 static void
1679 _gtk_rbtree_test_structure_helper (GtkRBTree *tree,
1680                                    GtkRBNode *node)
1681 {
1682   g_assert (node != tree->nil);
1683
1684   g_assert (node->left != NULL);
1685   g_assert (node->right != NULL);
1686   g_assert (node->parent != NULL);
1687
1688   if (node->left != tree->nil)
1689     {
1690       g_assert (node->left->parent == node);
1691       _gtk_rbtree_test_structure_helper (tree, node->left);
1692     }
1693   if (node->right != tree->nil)
1694     {
1695       g_assert (node->right->parent == node);
1696       _gtk_rbtree_test_structure_helper (tree, node->right);
1697     }
1698
1699   if (node->children != NULL)
1700     {
1701       g_assert (node->children->parent_tree == tree);
1702       g_assert (node->children->parent_node == node);
1703
1704       _gtk_rbtree_test_structure (node->children);
1705     }
1706 }
1707 static void
1708 _gtk_rbtree_test_structure (GtkRBTree *tree)
1709 {
1710   g_assert (tree->root);
1711   if (tree->root == tree->nil)
1712     return;
1713
1714   g_assert (tree->root->parent == tree->nil);
1715   _gtk_rbtree_test_structure_helper (tree, tree->root);
1716 }
1717
1718 static void
1719 _gtk_rbtree_test (const gchar *where,
1720                   GtkRBTree   *tree)
1721 {
1722   GtkRBTree *tmp_tree;
1723
1724   if (tree == NULL)
1725     return;
1726
1727   /* Test the entire tree */
1728   tmp_tree = tree;
1729   while (tmp_tree->parent_tree)
1730     tmp_tree = tmp_tree->parent_tree;
1731   
1732   g_assert (tmp_tree->nil != NULL);
1733
1734   if (tmp_tree->root == tmp_tree->nil)
1735     return;
1736
1737   _gtk_rbtree_test_structure (tmp_tree);
1738
1739   g_assert ((_count_nodes (tmp_tree, tmp_tree->root->left) +
1740              _count_nodes (tmp_tree, tmp_tree->root->right) + 1) == tmp_tree->root->count);
1741       
1742       
1743   _gtk_rbtree_test_height (tmp_tree, tmp_tree->root);
1744   _gtk_rbtree_test_dirty (tmp_tree, tmp_tree->root, GTK_RBNODE_FLAG_SET (tmp_tree->root, GTK_RBNODE_DESCENDANTS_INVALID));
1745   g_assert (count_total (tmp_tree, tmp_tree->root) == tmp_tree->root->total_count);
1746 }
1747
1748 static void
1749 _gtk_rbtree_debug_spew_helper (GtkRBTree *tree,
1750                                GtkRBNode *node,
1751                                gint       depth)
1752 {
1753   gint i;
1754   for (i = 0; i < depth; i++)
1755     g_print ("\t");
1756
1757   g_print ("(%p - %s) (Offset %d) (Parity %d) (Validity %d%d%d)\n",
1758            node,
1759            (GTK_RBNODE_GET_COLOR (node) == GTK_RBNODE_BLACK)?"BLACK":" RED ",
1760            node->offset,
1761            node->total_count,
1762            (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_DESCENDANTS_INVALID))?1:0,
1763            (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_INVALID))?1:0,
1764            (GTK_RBNODE_FLAG_SET (node, GTK_RBNODE_COLUMN_INVALID))?1:0);
1765   if (node->children != NULL)
1766     {
1767       g_print ("Looking at child.\n");
1768       _gtk_rbtree_debug_spew (node->children);
1769       g_print ("Done looking at child.\n");
1770     }
1771   if (node->left != tree->nil)
1772     {
1773       _gtk_rbtree_debug_spew_helper (tree, node->left, depth+1);
1774     }
1775   if (node->right != tree->nil)
1776     {
1777       _gtk_rbtree_debug_spew_helper (tree, node->right, depth+1);
1778     }
1779 }
1780
1781 static void
1782 _gtk_rbtree_debug_spew (GtkRBTree *tree)
1783 {
1784   g_return_if_fail (tree != NULL);
1785
1786   if (tree->root == tree->nil)
1787     g_print ("Empty tree...\n");
1788   else
1789     _gtk_rbtree_debug_spew_helper (tree, tree->root, 0);
1790 }
1791 #endif /* G_ENABLE_DEBUG */