clean-temp: Document limitations.
[gnulib.git] / lib / gl_avltreehash_list.c
blob9f795ff86483c8ffba022d2a4c3b7e0c634d5f6f
1 /* Sequential list data type implemented by a hash table with a binary tree.
2 Copyright (C) 2006, 2008-2020 Free Software Foundation, Inc.
3 Written by Bruno Haible <bruno@clisp.org>, 2006.
5 This program is free software: you can redistribute it and/or modify
6 it under the terms of the GNU General Public License as published by
7 the Free Software Foundation; either version 3 of the License, or
8 (at your option) any later version.
10 This program is distributed in the hope that it will be useful,
11 but WITHOUT ANY WARRANTY; without even the implied warranty of
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 GNU General Public License for more details.
15 You should have received a copy of the GNU General Public License
16 along with this program. If not, see <https://www.gnu.org/licenses/>. */
18 #include <config.h>
20 /* Specification. */
21 #include "gl_avltreehash_list.h"
23 #include <stdint.h> /* for uintptr_t, SIZE_MAX */
24 #include <stdlib.h>
26 #include "gl_avltree_oset.h"
27 #include "xsize.h"
29 #define WITH_HASHTABLE 1
31 /* Which kind of binary trees to use for ordered sets. Quite arbitrary. */
32 #define OSET_TREE_FLAVOR GL_AVLTREE_OSET
34 /* -------------------------- gl_list_t Data Type -------------------------- */
36 /* Generic hash-table code: Type definitions. */
37 #include "gl_anyhash1.h"
39 /* Generic AVL tree code: Type definitions. */
40 #include "gl_anyavltree_list1.h"
42 /* Generic hash-table code: Low-level code. */
43 #define CONTAINER_T gl_list_t
44 #define CONTAINER_COUNT(list) \
45 ((list)->root != NULL ? (list)->root->branch_size : 0)
46 #include "gl_anyhash2.h"
48 /* Generic binary tree code: Type definitions. */
49 #include "gl_anytree_list1.h"
51 /* Hash-table with binary tree code: Handling of hash buckets. */
52 #include "gl_anytreehash_list1.h"
54 /* Generic AVL tree code: Insertion/deletion algorithms. */
55 #include "gl_anyavltree_list2.h"
57 /* Generic binary tree code: Functions taking advantage of the hash table. */
58 #include "gl_anytreehash_list2.h"
60 /* Generic binary tree code: All other functions. */
61 #include "gl_anytree_list2.h"
63 /* For debugging. */
64 static unsigned int
65 check_invariants (gl_list_node_t node, gl_list_node_t parent)
67 unsigned int left_height =
68 (node->left != NULL ? check_invariants (node->left, node) : 0);
69 unsigned int right_height =
70 (node->right != NULL ? check_invariants (node->right, node) : 0);
71 int balance = (int)right_height - (int)left_height;
73 if (!(node->parent == parent))
74 abort ();
75 if (!(node->branch_size
76 == (node->left != NULL ? node->left->branch_size : 0)
77 + 1 + (node->right != NULL ? node->right->branch_size : 0)))
78 abort ();
79 if (!(balance >= -1 && balance <= 1))
80 abort ();
81 if (!(node->balance == balance))
82 abort ();
84 return 1 + (left_height > right_height ? left_height : right_height);
86 void
87 gl_avltreehash_list_check_invariants (gl_list_t list)
89 if (list->root != NULL)
90 check_invariants (list->root, NULL);
94 const struct gl_list_implementation gl_avltreehash_list_implementation =
96 gl_tree_nx_create_empty,
97 gl_tree_nx_create,
98 gl_tree_size,
99 gl_tree_node_value,
100 gl_tree_node_nx_set_value,
101 gl_tree_next_node,
102 gl_tree_previous_node,
103 gl_tree_get_at,
104 gl_tree_nx_set_at,
105 gl_tree_search_from_to,
106 gl_tree_indexof_from_to,
107 gl_tree_nx_add_first,
108 gl_tree_nx_add_last,
109 gl_tree_nx_add_before,
110 gl_tree_nx_add_after,
111 gl_tree_nx_add_at,
112 gl_tree_remove_node,
113 gl_tree_remove_at,
114 gl_tree_remove,
115 gl_tree_list_free,
116 gl_tree_iterator,
117 gl_tree_iterator_from_to,
118 gl_tree_iterator_next,
119 gl_tree_iterator_free,
120 gl_tree_sortedlist_search,
121 gl_tree_sortedlist_search_from_to,
122 gl_tree_sortedlist_indexof,
123 gl_tree_sortedlist_indexof_from_to,
124 gl_tree_sortedlist_nx_add,
125 gl_tree_sortedlist_remove