annotate gcc/hash-map.h @ 111:04ced10e8804

gcc 7
author kono
date Fri, 27 Oct 2017 22:46:09 +0900
parents
children 84e7813d76e9
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
111
kono
parents:
diff changeset
1 /* A type-safe hash map.
kono
parents:
diff changeset
2 Copyright (C) 2014-2017 Free Software Foundation, Inc.
kono
parents:
diff changeset
3
kono
parents:
diff changeset
4 This file is part of GCC.
kono
parents:
diff changeset
5
kono
parents:
diff changeset
6 GCC is free software; you can redistribute it and/or modify it under
kono
parents:
diff changeset
7 the terms of the GNU General Public License as published by the Free
kono
parents:
diff changeset
8 Software Foundation; either version 3, or (at your option) any later
kono
parents:
diff changeset
9 version.
kono
parents:
diff changeset
10
kono
parents:
diff changeset
11 GCC is distributed in the hope that it will be useful, but WITHOUT ANY
kono
parents:
diff changeset
12 WARRANTY; without even the implied warranty of MERCHANTABILITY or
kono
parents:
diff changeset
13 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
kono
parents:
diff changeset
14 for more details.
kono
parents:
diff changeset
15
kono
parents:
diff changeset
16 You should have received a copy of the GNU General Public License
kono
parents:
diff changeset
17 along with GCC; see the file COPYING3. If not see
kono
parents:
diff changeset
18 <http://www.gnu.org/licenses/>. */
kono
parents:
diff changeset
19
kono
parents:
diff changeset
20
kono
parents:
diff changeset
21 #ifndef hash_map_h
kono
parents:
diff changeset
22 #define hash_map_h
kono
parents:
diff changeset
23
kono
parents:
diff changeset
24 template<typename KeyId, typename Value,
kono
parents:
diff changeset
25 typename Traits>
kono
parents:
diff changeset
26 class GTY((user)) hash_map
kono
parents:
diff changeset
27 {
kono
parents:
diff changeset
28 typedef typename Traits::key_type Key;
kono
parents:
diff changeset
29 struct hash_entry
kono
parents:
diff changeset
30 {
kono
parents:
diff changeset
31 Key m_key;
kono
parents:
diff changeset
32 Value m_value;
kono
parents:
diff changeset
33
kono
parents:
diff changeset
34 typedef hash_entry value_type;
kono
parents:
diff changeset
35 typedef Key compare_type;
kono
parents:
diff changeset
36
kono
parents:
diff changeset
37 static hashval_t hash (const hash_entry &e)
kono
parents:
diff changeset
38 {
kono
parents:
diff changeset
39 return Traits::hash (e.m_key);
kono
parents:
diff changeset
40 }
kono
parents:
diff changeset
41
kono
parents:
diff changeset
42 static bool equal (const hash_entry &a, const Key &b)
kono
parents:
diff changeset
43 {
kono
parents:
diff changeset
44 return Traits::equal_keys (a.m_key, b);
kono
parents:
diff changeset
45 }
kono
parents:
diff changeset
46
kono
parents:
diff changeset
47 static void remove (hash_entry &e) { Traits::remove (e); }
kono
parents:
diff changeset
48
kono
parents:
diff changeset
49 static void mark_deleted (hash_entry &e) { Traits::mark_deleted (e); }
kono
parents:
diff changeset
50
kono
parents:
diff changeset
51 static bool is_deleted (const hash_entry &e)
kono
parents:
diff changeset
52 {
kono
parents:
diff changeset
53 return Traits::is_deleted (e);
kono
parents:
diff changeset
54 }
kono
parents:
diff changeset
55
kono
parents:
diff changeset
56 static void mark_empty (hash_entry &e) { Traits::mark_empty (e); }
kono
parents:
diff changeset
57 static bool is_empty (const hash_entry &e) { return Traits::is_empty (e); }
kono
parents:
diff changeset
58
kono
parents:
diff changeset
59 static void ggc_mx (hash_entry &e)
kono
parents:
diff changeset
60 {
kono
parents:
diff changeset
61 gt_ggc_mx (e.m_key);
kono
parents:
diff changeset
62 gt_ggc_mx (e.m_value);
kono
parents:
diff changeset
63 }
kono
parents:
diff changeset
64
kono
parents:
diff changeset
65 static void pch_nx (hash_entry &e)
kono
parents:
diff changeset
66 {
kono
parents:
diff changeset
67 gt_pch_nx (e.m_key);
kono
parents:
diff changeset
68 gt_pch_nx (e.m_value);
kono
parents:
diff changeset
69 }
kono
parents:
diff changeset
70
kono
parents:
diff changeset
71 static void pch_nx (hash_entry &e, gt_pointer_operator op, void *c)
kono
parents:
diff changeset
72 {
kono
parents:
diff changeset
73 pch_nx_helper (e.m_key, op, c);
kono
parents:
diff changeset
74 pch_nx_helper (e.m_value, op, c);
kono
parents:
diff changeset
75 }
kono
parents:
diff changeset
76
kono
parents:
diff changeset
77 private:
kono
parents:
diff changeset
78 template<typename T>
kono
parents:
diff changeset
79 static void
kono
parents:
diff changeset
80 pch_nx_helper (T &x, gt_pointer_operator op, void *cookie)
kono
parents:
diff changeset
81 {
kono
parents:
diff changeset
82 gt_pch_nx (&x, op, cookie);
kono
parents:
diff changeset
83 }
kono
parents:
diff changeset
84
kono
parents:
diff changeset
85 static void
kono
parents:
diff changeset
86 pch_nx_helper (int, gt_pointer_operator, void *)
kono
parents:
diff changeset
87 {
kono
parents:
diff changeset
88 }
kono
parents:
diff changeset
89
kono
parents:
diff changeset
90 static void
kono
parents:
diff changeset
91 pch_nx_helper (unsigned int, gt_pointer_operator, void *)
kono
parents:
diff changeset
92 {
kono
parents:
diff changeset
93 }
kono
parents:
diff changeset
94
kono
parents:
diff changeset
95 static void
kono
parents:
diff changeset
96 pch_nx_helper (bool, gt_pointer_operator, void *)
kono
parents:
diff changeset
97 {
kono
parents:
diff changeset
98 }
kono
parents:
diff changeset
99
kono
parents:
diff changeset
100 template<typename T>
kono
parents:
diff changeset
101 static void
kono
parents:
diff changeset
102 pch_nx_helper (T *&x, gt_pointer_operator op, void *cookie)
kono
parents:
diff changeset
103 {
kono
parents:
diff changeset
104 op (&x, cookie);
kono
parents:
diff changeset
105 }
kono
parents:
diff changeset
106 };
kono
parents:
diff changeset
107
kono
parents:
diff changeset
108 public:
kono
parents:
diff changeset
109 explicit hash_map (size_t n = 13, bool ggc = false,
kono
parents:
diff changeset
110 bool gather_mem_stats = GATHER_STATISTICS
kono
parents:
diff changeset
111 CXX_MEM_STAT_INFO)
kono
parents:
diff changeset
112 : m_table (n, ggc, gather_mem_stats, HASH_MAP_ORIGIN PASS_MEM_STAT) {}
kono
parents:
diff changeset
113
kono
parents:
diff changeset
114 explicit hash_map (const hash_map &h, bool ggc = false,
kono
parents:
diff changeset
115 bool gather_mem_stats = GATHER_STATISTICS
kono
parents:
diff changeset
116 CXX_MEM_STAT_INFO)
kono
parents:
diff changeset
117 : m_table (h.m_table, ggc, gather_mem_stats,
kono
parents:
diff changeset
118 HASH_MAP_ORIGIN PASS_MEM_STAT) {}
kono
parents:
diff changeset
119
kono
parents:
diff changeset
120 /* Create a hash_map in ggc memory. */
kono
parents:
diff changeset
121 static hash_map *create_ggc (size_t size,
kono
parents:
diff changeset
122 bool gather_mem_stats = GATHER_STATISTICS
kono
parents:
diff changeset
123 CXX_MEM_STAT_INFO)
kono
parents:
diff changeset
124 {
kono
parents:
diff changeset
125 hash_map *map = ggc_alloc<hash_map> ();
kono
parents:
diff changeset
126 new (map) hash_map (size, true, gather_mem_stats PASS_MEM_STAT);
kono
parents:
diff changeset
127 return map;
kono
parents:
diff changeset
128 }
kono
parents:
diff changeset
129
kono
parents:
diff changeset
130 /* If key k isn't already in the map add key k with value v to the map, and
kono
parents:
diff changeset
131 return false. Otherwise set the value of the entry for key k to be v and
kono
parents:
diff changeset
132 return true. */
kono
parents:
diff changeset
133
kono
parents:
diff changeset
134 bool put (const Key &k, const Value &v)
kono
parents:
diff changeset
135 {
kono
parents:
diff changeset
136 hash_entry *e = m_table.find_slot_with_hash (k, Traits::hash (k),
kono
parents:
diff changeset
137 INSERT);
kono
parents:
diff changeset
138 bool existed = !hash_entry::is_empty (*e);
kono
parents:
diff changeset
139 if (!existed)
kono
parents:
diff changeset
140 e->m_key = k;
kono
parents:
diff changeset
141
kono
parents:
diff changeset
142 e->m_value = v;
kono
parents:
diff changeset
143 return existed;
kono
parents:
diff changeset
144 }
kono
parents:
diff changeset
145
kono
parents:
diff changeset
146 /* if the passed in key is in the map return its value otherwise NULL. */
kono
parents:
diff changeset
147
kono
parents:
diff changeset
148 Value *get (const Key &k)
kono
parents:
diff changeset
149 {
kono
parents:
diff changeset
150 hash_entry &e = m_table.find_with_hash (k, Traits::hash (k));
kono
parents:
diff changeset
151 return Traits::is_empty (e) ? NULL : &e.m_value;
kono
parents:
diff changeset
152 }
kono
parents:
diff changeset
153
kono
parents:
diff changeset
154 /* Return a reference to the value for the passed in key, creating the entry
kono
parents:
diff changeset
155 if it doesn't already exist. If existed is not NULL then it is set to false
kono
parents:
diff changeset
156 if the key was not previously in the map, and true otherwise. */
kono
parents:
diff changeset
157
kono
parents:
diff changeset
158 Value &get_or_insert (const Key &k, bool *existed = NULL)
kono
parents:
diff changeset
159 {
kono
parents:
diff changeset
160 hash_entry *e = m_table.find_slot_with_hash (k, Traits::hash (k),
kono
parents:
diff changeset
161 INSERT);
kono
parents:
diff changeset
162 bool ins = Traits::is_empty (*e);
kono
parents:
diff changeset
163 if (ins)
kono
parents:
diff changeset
164 e->m_key = k;
kono
parents:
diff changeset
165
kono
parents:
diff changeset
166 if (existed != NULL)
kono
parents:
diff changeset
167 *existed = !ins;
kono
parents:
diff changeset
168
kono
parents:
diff changeset
169 return e->m_value;
kono
parents:
diff changeset
170 }
kono
parents:
diff changeset
171
kono
parents:
diff changeset
172 void remove (const Key &k)
kono
parents:
diff changeset
173 {
kono
parents:
diff changeset
174 m_table.remove_elt_with_hash (k, Traits::hash (k));
kono
parents:
diff changeset
175 }
kono
parents:
diff changeset
176
kono
parents:
diff changeset
177 /* Call the call back on each pair of key and value with the passed in
kono
parents:
diff changeset
178 arg. */
kono
parents:
diff changeset
179
kono
parents:
diff changeset
180 template<typename Arg, bool (*f)(const typename Traits::key_type &,
kono
parents:
diff changeset
181 const Value &, Arg)>
kono
parents:
diff changeset
182 void traverse (Arg a) const
kono
parents:
diff changeset
183 {
kono
parents:
diff changeset
184 for (typename hash_table<hash_entry>::iterator iter = m_table.begin ();
kono
parents:
diff changeset
185 iter != m_table.end (); ++iter)
kono
parents:
diff changeset
186 f ((*iter).m_key, (*iter).m_value, a);
kono
parents:
diff changeset
187 }
kono
parents:
diff changeset
188
kono
parents:
diff changeset
189 template<typename Arg, bool (*f)(const typename Traits::key_type &,
kono
parents:
diff changeset
190 Value *, Arg)>
kono
parents:
diff changeset
191 void traverse (Arg a) const
kono
parents:
diff changeset
192 {
kono
parents:
diff changeset
193 for (typename hash_table<hash_entry>::iterator iter = m_table.begin ();
kono
parents:
diff changeset
194 iter != m_table.end (); ++iter)
kono
parents:
diff changeset
195 if (!f ((*iter).m_key, &(*iter).m_value, a))
kono
parents:
diff changeset
196 break;
kono
parents:
diff changeset
197 }
kono
parents:
diff changeset
198
kono
parents:
diff changeset
199 size_t elements () const { return m_table.elements (); }
kono
parents:
diff changeset
200
kono
parents:
diff changeset
201 void empty () { m_table.empty(); }
kono
parents:
diff changeset
202
kono
parents:
diff changeset
203 class iterator
kono
parents:
diff changeset
204 {
kono
parents:
diff changeset
205 public:
kono
parents:
diff changeset
206 explicit iterator (const typename hash_table<hash_entry>::iterator &iter) :
kono
parents:
diff changeset
207 m_iter (iter) {}
kono
parents:
diff changeset
208
kono
parents:
diff changeset
209 iterator &operator++ ()
kono
parents:
diff changeset
210 {
kono
parents:
diff changeset
211 ++m_iter;
kono
parents:
diff changeset
212 return *this;
kono
parents:
diff changeset
213 }
kono
parents:
diff changeset
214
kono
parents:
diff changeset
215 std::pair<Key, Value> operator* ()
kono
parents:
diff changeset
216 {
kono
parents:
diff changeset
217 hash_entry &e = *m_iter;
kono
parents:
diff changeset
218 return std::pair<Key, Value> (e.m_key, e.m_value);
kono
parents:
diff changeset
219 }
kono
parents:
diff changeset
220
kono
parents:
diff changeset
221 bool
kono
parents:
diff changeset
222 operator != (const iterator &other) const
kono
parents:
diff changeset
223 {
kono
parents:
diff changeset
224 return m_iter != other.m_iter;
kono
parents:
diff changeset
225 }
kono
parents:
diff changeset
226
kono
parents:
diff changeset
227 private:
kono
parents:
diff changeset
228 typename hash_table<hash_entry>::iterator m_iter;
kono
parents:
diff changeset
229 };
kono
parents:
diff changeset
230
kono
parents:
diff changeset
231 /* Standard iterator retrieval methods. */
kono
parents:
diff changeset
232
kono
parents:
diff changeset
233 iterator begin () const { return iterator (m_table.begin ()); }
kono
parents:
diff changeset
234 iterator end () const { return iterator (m_table.end ()); }
kono
parents:
diff changeset
235
kono
parents:
diff changeset
236 private:
kono
parents:
diff changeset
237
kono
parents:
diff changeset
238 template<typename T, typename U, typename V> friend void gt_ggc_mx (hash_map<T, U, V> *);
kono
parents:
diff changeset
239 template<typename T, typename U, typename V> friend void gt_pch_nx (hash_map<T, U, V> *);
kono
parents:
diff changeset
240 template<typename T, typename U, typename V> friend void gt_pch_nx (hash_map<T, U, V> *, gt_pointer_operator, void *);
kono
parents:
diff changeset
241
kono
parents:
diff changeset
242 hash_table<hash_entry> m_table;
kono
parents:
diff changeset
243 };
kono
parents:
diff changeset
244
kono
parents:
diff changeset
245 /* ggc marking routines. */
kono
parents:
diff changeset
246
kono
parents:
diff changeset
247 template<typename K, typename V, typename H>
kono
parents:
diff changeset
248 static inline void
kono
parents:
diff changeset
249 gt_ggc_mx (hash_map<K, V, H> *h)
kono
parents:
diff changeset
250 {
kono
parents:
diff changeset
251 gt_ggc_mx (&h->m_table);
kono
parents:
diff changeset
252 }
kono
parents:
diff changeset
253
kono
parents:
diff changeset
254 template<typename K, typename V, typename H>
kono
parents:
diff changeset
255 static inline void
kono
parents:
diff changeset
256 gt_pch_nx (hash_map<K, V, H> *h)
kono
parents:
diff changeset
257 {
kono
parents:
diff changeset
258 gt_pch_nx (&h->m_table);
kono
parents:
diff changeset
259 }
kono
parents:
diff changeset
260
kono
parents:
diff changeset
261 template<typename K, typename V, typename H>
kono
parents:
diff changeset
262 static inline void
kono
parents:
diff changeset
263 gt_pch_nx (hash_map<K, V, H> *h, gt_pointer_operator op, void *cookie)
kono
parents:
diff changeset
264 {
kono
parents:
diff changeset
265 op (&h->m_table.m_entries, cookie);
kono
parents:
diff changeset
266 }
kono
parents:
diff changeset
267
kono
parents:
diff changeset
268 #endif