1 | |
---|
2 | #include <collections/list.hfa> |
---|
3 | |
---|
4 | typedef unsigned int K; |
---|
5 | |
---|
6 | // workaround type for trac#185; used here as the ticket's examples use a spontaneous float |
---|
7 | typedef struct {} t_unused; |
---|
8 | |
---|
9 | struct request { |
---|
10 | |
---|
11 | unsigned int src_id; |
---|
12 | unsigned int tgt_id; |
---|
13 | |
---|
14 | DLISTED_MGD_EXPL_IN(request, ht_by_src) |
---|
15 | DLISTED_MGD_EXPL_IN(request, ht_by_tgt) |
---|
16 | }; |
---|
17 | DLISTED_MGD_EXPL_OUT(request, ht_by_src) |
---|
18 | DLISTED_MGD_EXPL_OUT(request, ht_by_tgt) |
---|
19 | |
---|
20 | size_t hash( unsigned int k ) { |
---|
21 | // not really a hash function, not really the point |
---|
22 | return k; |
---|
23 | } |
---|
24 | |
---|
25 | unsigned int key( request_in_ht_by_src & v ) { |
---|
26 | return v.src_id; |
---|
27 | } |
---|
28 | |
---|
29 | |
---|
30 | #include <exception.hfa> |
---|
31 | |
---|
32 | DATA_EXCEPTION(ht_fill_limit_crossed)( |
---|
33 | void * theHashtable; |
---|
34 | bool want_throwResume_ht_auto_resize_pending; |
---|
35 | size_t size_for_ht_auto_resize_pending; |
---|
36 | ); |
---|
37 | |
---|
38 | void ?{}(ht_fill_limit_crossed & this, void * theHashtable) { |
---|
39 | VTABLE_INIT(this, ht_fill_limit_crossed); |
---|
40 | this.theHashtable = theHashtable; |
---|
41 | this.want_throwResume_ht_auto_resize_pending = false; |
---|
42 | this.size_for_ht_auto_resize_pending = 0; |
---|
43 | } |
---|
44 | |
---|
45 | const char * ht_fill_limit_crossed_msg(ht_fill_limit_crossed * this) { |
---|
46 | return "ht_fill_limit_crossed"; |
---|
47 | } |
---|
48 | |
---|
49 | VTABLE_INSTANCE(ht_fill_limit_crossed)(ht_fill_limit_crossed_msg); |
---|
50 | |
---|
51 | |
---|
52 | DATA_EXCEPTION(ht_auto_resize_pending)( |
---|
53 | void * theHashtable; |
---|
54 | size_t new_size; |
---|
55 | ); |
---|
56 | |
---|
57 | void ?{}(ht_auto_resize_pending & this, void * theHashtable, size_t new_size) { |
---|
58 | VTABLE_INIT(this, ht_auto_resize_pending); |
---|
59 | this.theHashtable = theHashtable; |
---|
60 | this.new_size = new_size; |
---|
61 | } |
---|
62 | |
---|
63 | const char * ht_auto_resize_pending_msg(ht_auto_resize_pending * this) { |
---|
64 | return "ht_auto_resize_pending"; |
---|
65 | } |
---|
66 | |
---|
67 | VTABLE_INSTANCE(ht_auto_resize_pending)(ht_auto_resize_pending_msg); |
---|
68 | |
---|
69 | |
---|
70 | |
---|
71 | trait pretendsToMatter( TTT & ) { |
---|
72 | void actsmart(TTT &); |
---|
73 | }; |
---|
74 | |
---|
75 | forall( TTTx & ) |
---|
76 | void actsmart(TTTx &) {} |
---|
77 | |
---|
78 | // probable bug, wrt otype Tt_unused... |
---|
79 | // 1. changing to dtype Tt_unused crashes GenPoly |
---|
80 | // 2. declaring function check_ff_warning as concrete, i.e. operating on type hashtable_rbs(t_unused) makes cfa-cc generate bad C |
---|
81 | // in both cases, it's on the throwResume call |
---|
82 | // where it implicitly uses this.defaultResumptionHandler as a throwResume argument |
---|
83 | // whereas that, of course, has to be surrounded in a cast |
---|
84 | // at GenPoly breakpoint, type of said cast appears as CFA generic struct, even as the "this" parameter appears as C struct; casted type ... |
---|
85 | // 1. is hashtable_rbs(Tt_unused); assertion complains you don't need a type arg here |
---|
86 | // 2. shows up in -CFA output as hashtable_rbs(), which is bad C; expecting hashtable_rbs* |
---|
87 | |
---|
88 | forall( Tt_unused | pretendsToMatter(Tt_unused) ) { |
---|
89 | |
---|
90 | // hashtable of request by source |
---|
91 | struct hashtable_rbs { |
---|
92 | |
---|
93 | size_t n_buckets; |
---|
94 | dlist(request_in_ht_by_src, request) *buckets; |
---|
95 | |
---|
96 | size_t item_count; |
---|
97 | float ff_next_warn_up; |
---|
98 | float ff_warn_step_factor; |
---|
99 | |
---|
100 | void (*defaultResumptionHandler) (ht_fill_limit_crossed &); |
---|
101 | }; |
---|
102 | |
---|
103 | void ?{}( hashtable_rbs(Tt_unused) & this ) = void; |
---|
104 | } |
---|
105 | |
---|
106 | forall( Tt_unused | pretendsToMatter(Tt_unused) | { void defaultResumptionHandler(ht_fill_limit_crossed &); } ) { |
---|
107 | |
---|
108 | void ?{}( hashtable_rbs(Tt_unused) & this, size_t n_buckets, dlist(request_in_ht_by_src, request) *buckets, |
---|
109 | float ff_next_warn_up, float ff_warn_step_factor ) { |
---|
110 | |
---|
111 | printf( "base hashtable ctor with %ld buckets at %p\n", n_buckets, buckets); |
---|
112 | |
---|
113 | this.n_buckets = n_buckets; |
---|
114 | this.buckets = buckets; |
---|
115 | |
---|
116 | this.item_count = 0; |
---|
117 | this.ff_next_warn_up = ff_next_warn_up; |
---|
118 | this.ff_warn_step_factor = ff_warn_step_factor; |
---|
119 | |
---|
120 | this.defaultResumptionHandler = defaultResumptionHandler; |
---|
121 | |
---|
122 | for ( i; n_buckets ) { |
---|
123 | ?{}( this.buckets[i] ); |
---|
124 | } |
---|
125 | } |
---|
126 | |
---|
127 | void ?{}( hashtable_rbs(Tt_unused) & this, size_t n_buckets, dlist(request_in_ht_by_src, request) *buckets ) { |
---|
128 | printf( "base hashtable ctor with default warning steps\n" ); |
---|
129 | ( this ) { n_buckets, buckets, 0.5, 2 }; |
---|
130 | } |
---|
131 | |
---|
132 | } |
---|
133 | |
---|
134 | // this fwd declaration is artifact of workaround trac#192 |
---|
135 | void defaultResumptionHandler( ht_auto_resize_pending & ex ); |
---|
136 | |
---|
137 | forall( Tt_unused | pretendsToMatter(Tt_unused) ) { |
---|
138 | |
---|
139 | float fill_frac( hashtable_rbs(Tt_unused) & this ) with(this) { |
---|
140 | return ((float)item_count) / n_buckets; |
---|
141 | } |
---|
142 | |
---|
143 | size_t bucket_of( hashtable_rbs(Tt_unused) & this, K k ) { |
---|
144 | return hash(k) % this.n_buckets; |
---|
145 | } |
---|
146 | |
---|
147 | request & get( hashtable_rbs(Tt_unused) & this, K k ) with (this) { |
---|
148 | |
---|
149 | dlist(request_in_ht_by_src, request) & bucket = buckets[ bucket_of(this, k) ]; |
---|
150 | |
---|
151 | for ( request_in_ht_by_src * item = & $tempcv_e2n(bucket`first); item != 0p; item = & $tempcv_e2n((*item)`next) ) { |
---|
152 | if ( key(*item) == k ) { |
---|
153 | return *item; |
---|
154 | } |
---|
155 | } |
---|
156 | |
---|
157 | return *0p; |
---|
158 | } |
---|
159 | |
---|
160 | void check_ff_warning( hashtable_rbs(Tt_unused) & this ) with (this) { |
---|
161 | if (fill_frac(this) > ff_next_warn_up) { |
---|
162 | ht_fill_limit_crossed ex1 = { &this }; |
---|
163 | throwResume ex1; |
---|
164 | // workaround trac#192: want the second throwResume to be in __dynamic_defaultResumptionHandler |
---|
165 | // ... want base hashtable decoupled from resize |
---|
166 | if ( ex1.want_throwResume_ht_auto_resize_pending ) { |
---|
167 | throwResume( (ht_auto_resize_pending) { & this, ex1.size_for_ht_auto_resize_pending } ); |
---|
168 | } |
---|
169 | } |
---|
170 | } |
---|
171 | |
---|
172 | void put( hashtable_rbs(Tt_unused) & this, request & v ) with (this) { |
---|
173 | |
---|
174 | check_ff_warning(this); |
---|
175 | |
---|
176 | K k = key( $tempcv_e2n(v) ); |
---|
177 | dlist(request_in_ht_by_src, request) & bucket = buckets[ bucket_of(this, k) ]; |
---|
178 | |
---|
179 | for ( request_in_ht_by_src * item = & $tempcv_e2n(bucket`first); item != 0p; item = & $tempcv_e2n((*item)`next) ) { |
---|
180 | if ( key(*item) == k ) { |
---|
181 | remove(*item); |
---|
182 | break; |
---|
183 | } |
---|
184 | } |
---|
185 | |
---|
186 | insert_first(bucket, v); |
---|
187 | this.item_count ++; |
---|
188 | } |
---|
189 | } |
---|
190 | |
---|
191 | |
---|
192 | |
---|
193 | |
---|
194 | // tactical usage: |
---|
195 | // HASHTABLE_RBS_STATIC(n, ht) |
---|
196 | // |
---|
197 | // intended equivalent: |
---|
198 | // hashtable_rbs_static(Z(n)) ht; |
---|
199 | #define HASHTABLE_RBS_STATIC(n_buckets, obj) \ |
---|
200 | struct __hashtable_static_ ## obj { \ |
---|
201 | inline hashtable_rbs(t_unused); \ |
---|
202 | dlist(request_in_ht_by_src, request) $items[n_buckets]; \ |
---|
203 | }; \ |
---|
204 | void ?{}( __hashtable_static_ ## obj & this ) { \ |
---|
205 | ((hashtable_rbs(t_unused) &)this){ n_buckets, this.$items }; \ |
---|
206 | } \ |
---|
207 | __hashtable_static_ ## obj obj; |
---|
208 | |
---|
209 | |
---|
210 | |
---|
211 | void defaultResumptionHandler(ht_fill_limit_crossed & ex) { |
---|
212 | hashtable_rbs(t_unused) & ht = *(hashtable_rbs(t_unused) *)ex.theHashtable; |
---|
213 | printf("base default resumption handler ht_fill_limit_crossed with ht filled at %f\n", fill_frac(ht)); |
---|
214 | ht.ff_next_warn_up *= ht.ff_warn_step_factor; |
---|
215 | } |
---|
216 | |
---|
217 | void defaultTerminationHandler(ht_fill_limit_crossed &) = void; |
---|
218 | |
---|
219 | |
---|
220 | |
---|
221 | |
---|
222 | |
---|
223 | trait heaped(T &) { |
---|
224 | T * alloc( size_t ); |
---|
225 | void free( void * ); |
---|
226 | }; |
---|
227 | |
---|
228 | void __dynamic_defaultResumptionHandler(ht_fill_limit_crossed &); |
---|
229 | |
---|
230 | forall( Tt_unused ) { |
---|
231 | |
---|
232 | struct hashtable_rbs_dynamic { |
---|
233 | inline hashtable_rbs(Tt_unused); |
---|
234 | |
---|
235 | struct resize_policy { |
---|
236 | // When fill factor exceeds grow limit, grow big enough for |
---|
237 | // resulting fill factor to be lower than grow_target. Vice versa. |
---|
238 | // Using different grow and shrink limits prevents noisy current |
---|
239 | // size from triggering grow-shrink oscillation. OK to use same |
---|
240 | // grow and shrink targets. |
---|
241 | float grow_limit, shrink_limit, grow_target, shrink_target; |
---|
242 | |
---|
243 | // warn with exception but do nothing, this many -1 times, then actually resize |
---|
244 | unsigned short int warns_per_grow, warns_per_shrink; |
---|
245 | |
---|
246 | // Don't shrink below. |
---|
247 | size_t nbuckets_floor; |
---|
248 | } policy; |
---|
249 | |
---|
250 | dlist(request_in_ht_by_src, request) * (*alloc)( size_t ); |
---|
251 | void (*free)( void * ); |
---|
252 | }; |
---|
253 | } |
---|
254 | |
---|
255 | // will be in list api |
---|
256 | void splice_all_to_last( dlist(request_in_ht_by_src, request) & src_to_empty, dlist(request_in_ht_by_src, request) & snk_to_fill_at_last ) { |
---|
257 | |
---|
258 | // will re-implement as an actual splice |
---|
259 | while ( & src_to_empty`first != 0p ) { |
---|
260 | insert_last( snk_to_fill_at_last, pop_first( src_to_empty ) ); |
---|
261 | } |
---|
262 | } |
---|
263 | |
---|
264 | |
---|
265 | forall( Tt_unused | heaped( dlist(request_in_ht_by_src, request) ) ) { |
---|
266 | |
---|
267 | void ?{}( hashtable_rbs_dynamic(Tt_unused).resize_policy & this, size_t nbuckets_floor ) { |
---|
268 | printf("default dynamic policy ctor\n"); |
---|
269 | |
---|
270 | (this.grow_limit) {2.0}; |
---|
271 | (this.shrink_limit) {0.5}; |
---|
272 | (this.grow_target) {1.0}; |
---|
273 | (this.shrink_target) {1.0}; |
---|
274 | (this.warns_per_grow) {4}; |
---|
275 | (this.warns_per_shrink){4}; |
---|
276 | (this.nbuckets_floor) {nbuckets_floor}; |
---|
277 | } |
---|
278 | |
---|
279 | void ?{}( hashtable_rbs_dynamic(Tt_unused) & this, size_t n_buckets, hashtable_rbs_dynamic(Tt_unused).resize_policy rp ) { |
---|
280 | printf("ctor hashtable_rbs_dynamic{ size_t, resize_policy }\n"); |
---|
281 | |
---|
282 | float first_first_warn_up = rp.grow_target; |
---|
283 | float ff_warn_step_factor = (rp.grow_limit / rp.grow_target) \ ( 1. / rp.warns_per_grow ); |
---|
284 | |
---|
285 | void (*defaultResumptionHandler) (ht_fill_limit_crossed &) = __dynamic_defaultResumptionHandler; |
---|
286 | dlist(request_in_ht_by_src, request) *buckets = alloc(n_buckets); |
---|
287 | ( ( hashtable_rbs( Tt_unused ) & ) this ){ n_buckets, buckets, first_first_warn_up, ff_warn_step_factor }; |
---|
288 | ( this.policy ){ rp }; |
---|
289 | this.alloc = alloc; |
---|
290 | this.free = free; |
---|
291 | } |
---|
292 | void ?{}( hashtable_rbs_dynamic(Tt_unused) & this, hashtable_rbs_dynamic(Tt_unused).resize_policy rp ) { |
---|
293 | printf("ctor hashtable_rbs_dynamic{ resize_policy }\n"); |
---|
294 | ( this ) { rp.nbuckets_floor, rp }; |
---|
295 | } |
---|
296 | void ?{}( hashtable_rbs_dynamic(Tt_unused) & this, size_t n_buckets ) { |
---|
297 | printf("ctor hashtable_rbs_dynamic{ size_t }\n"); |
---|
298 | ( this ) { n_buckets, (hashtable_rbs_dynamic(Tt_unused).resize_policy){ n_buckets } }; |
---|
299 | } |
---|
300 | void ^?{}( hashtable_rbs_dynamic(Tt_unused) & this ) { |
---|
301 | free(this.buckets); |
---|
302 | } |
---|
303 | void rehashToLarger( hashtable_rbs_dynamic(Tt_unused) & this, size_t new_n_buckets ) with(this) { |
---|
304 | printf("resizing from %ld to %ld, old buckets at %p\n", n_buckets, new_n_buckets, buckets); |
---|
305 | |
---|
306 | // collect hash items from old buckets |
---|
307 | dlist(request_in_ht_by_src, request) items; |
---|
308 | for (i; n_buckets) { |
---|
309 | splice_all_to_last( buckets[i], items ); |
---|
310 | } |
---|
311 | |
---|
312 | // make empty hash table of new size |
---|
313 | dlist(request_in_ht_by_src, request) *oldBuckets = buckets; |
---|
314 | float oldFfWarnStepFactor = ff_warn_step_factor; |
---|
315 | float newFfNextWarnUp = ((float)item_count) / ((float) new_n_buckets); |
---|
316 | ^?{}( (hashtable_rbs(Tt_unused) &)this ); |
---|
317 | free( oldBuckets ); |
---|
318 | ?{}( (hashtable_rbs(Tt_unused) &)this, new_n_buckets, alloc(new_n_buckets), newFfNextWarnUp, oldFfWarnStepFactor ); |
---|
319 | |
---|
320 | // fill new table with old items |
---|
321 | while ( & items`first != 0p ) { |
---|
322 | put( this, pop_first( items ) ); |
---|
323 | } |
---|
324 | } |
---|
325 | } |
---|
326 | |
---|
327 | forall( Tt_unused ) { |
---|
328 | void rehashToLarger_STEP( hashtable_rbs_dynamic(Tt_unused) & this, size_t new_n_buckets ) with (this) { |
---|
329 | rehashToLarger( this, new_n_buckets ); |
---|
330 | } |
---|
331 | } |
---|
332 | |
---|
333 | void defaultResumptionHandler( ht_auto_resize_pending & ex ) { |
---|
334 | hashtable_rbs_dynamic(t_unused) & ht = *(hashtable_rbs_dynamic(t_unused) *)ex.theHashtable; |
---|
335 | printf("auto-resize unhandled: proceeding with resize\n"); |
---|
336 | rehashToLarger_STEP( ht, ex.new_size ); |
---|
337 | } |
---|
338 | |
---|
339 | void __dynamic_defaultResumptionHandler(ht_fill_limit_crossed & ex) { |
---|
340 | hashtable_rbs_dynamic(t_unused) & ht = *(hashtable_rbs_dynamic(t_unused) *)ex.theHashtable; |
---|
341 | printf("dynamic warning received with fill_frac = %f and buckets at %p\n", fill_frac(ht), ht.buckets); |
---|
342 | if ( fill_frac( ht ) >= ht.policy.grow_limit ) { |
---|
343 | float grow_amount = ht.policy.grow_limit / ht.policy.grow_target; |
---|
344 | ex.want_throwResume_ht_auto_resize_pending = true; |
---|
345 | ex.size_for_ht_auto_resize_pending = ( size_t )( grow_amount * ht.n_buckets ); |
---|
346 | } else { |
---|
347 | // base handler, not specialized for dynamic |
---|
348 | defaultResumptionHandler( ex ); |
---|
349 | } |
---|
350 | } |
---|
351 | |
---|
352 | |
---|
353 | |
---|
354 | |
---|
355 | |
---|
356 | |
---|
357 | #include <stdlib.hfa> |
---|
358 | |
---|
359 | void basicFillingTestHelper( hashtable_rbs(t_unused) & ht, size_t n_elems ) { |
---|
360 | |
---|
361 | request & wasnt_found = get(ht, 17); |
---|
362 | assert( &wasnt_found == 0p ); |
---|
363 | |
---|
364 | request r; |
---|
365 | r.src_id = 117; |
---|
366 | r.tgt_id = 998; |
---|
367 | |
---|
368 | put(ht, r); |
---|
369 | |
---|
370 | request & found = get(ht, 117); |
---|
371 | assert( &found == &r ); |
---|
372 | |
---|
373 | & wasnt_found = & get(ht, 998); |
---|
374 | assert( &wasnt_found == 0p ); |
---|
375 | |
---|
376 | request rs[n_elems]; |
---|
377 | for (i; n_elems) { |
---|
378 | rs[i].src_id = 8000 * i; |
---|
379 | put(ht, rs[i]); |
---|
380 | } |
---|
381 | |
---|
382 | assert( & get(ht, 117 ) ); |
---|
383 | assert( & get(ht, 8000*25 ) ); |
---|
384 | assert(! & get(ht, 8000*25+1) ); |
---|
385 | } |
---|
386 | |
---|
387 | void basicFillingTest_static() { |
---|
388 | |
---|
389 | printf("---start basic fill test static ----\n"); |
---|
390 | |
---|
391 | HASHTABLE_RBS_STATIC(67, ht) |
---|
392 | |
---|
393 | basicFillingTestHelper(ht, 500); |
---|
394 | } |
---|
395 | |
---|
396 | void basicFillingTest_dynamic() { |
---|
397 | |
---|
398 | dlist(request_in_ht_by_src, request) * (*old_alloc)( size_t ) = alloc; |
---|
399 | dlist(request_in_ht_by_src, request) * alloc( size_t n ) { |
---|
400 | dlist(request_in_ht_by_src, request) * ret = old_alloc(n); |
---|
401 | printf("alloc'ed at %p\n", ret); |
---|
402 | return ret; |
---|
403 | } |
---|
404 | |
---|
405 | void (*old_free)( void * ) = free; |
---|
406 | void free( void * o ) { |
---|
407 | printf("free'ing at %p\n", o); |
---|
408 | old_free(o); |
---|
409 | } |
---|
410 | |
---|
411 | printf("---start basic fill test dynamic ----\n"); |
---|
412 | |
---|
413 | hashtable_rbs_dynamic(t_unused) ht = { 113 }; |
---|
414 | |
---|
415 | basicFillingTestHelper(ht, 500); |
---|
416 | } |
---|
417 | |
---|
418 | // Demonstrates user-provided instrumentation monitoring a fixed-size hash table |
---|
419 | void logTest() { |
---|
420 | |
---|
421 | printf("---start log test ----\n"); |
---|
422 | |
---|
423 | HASHTABLE_RBS_STATIC(67, ht) |
---|
424 | |
---|
425 | try { |
---|
426 | basicFillingTestHelper(ht, 500); |
---|
427 | } catchResume( ht_fill_limit_crossed * ) { |
---|
428 | printf("log test instrumentation runs\n"); |
---|
429 | throwResume; |
---|
430 | } |
---|
431 | } |
---|
432 | |
---|
433 | // Demonstrates "snoozing" a growing hash table's auto-resize event, |
---|
434 | // in that that next call to put will get the resize exception instead. |
---|
435 | void snoozeTest() { |
---|
436 | |
---|
437 | printf("---start snooze test ----\n"); |
---|
438 | |
---|
439 | hashtable_rbs_dynamic(t_unused) ht = { 113 }; |
---|
440 | |
---|
441 | bool lastResizeSnoozed = false; |
---|
442 | |
---|
443 | try { |
---|
444 | basicFillingTestHelper(ht, 500); |
---|
445 | } catchResume( ht_auto_resize_pending * ) { |
---|
446 | |
---|
447 | if ( lastResizeSnoozed == false ) { |
---|
448 | lastResizeSnoozed = true; |
---|
449 | printf("snooze test intervention decides to snooze this time\n"); |
---|
450 | } else { |
---|
451 | lastResizeSnoozed = false; |
---|
452 | printf("snooze test intervention decides to allow the resize\n"); |
---|
453 | throwResume; |
---|
454 | } |
---|
455 | |
---|
456 | } |
---|
457 | } |
---|
458 | |
---|
459 | int main() { |
---|
460 | |
---|
461 | basicFillingTest_static(); |
---|
462 | basicFillingTest_dynamic(); |
---|
463 | |
---|
464 | logTest(); |
---|
465 | snoozeTest(); |
---|
466 | } |
---|