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