3 // Copyright (C) 2005, 2006, 2007 Free Software Foundation, Inc.
5 // This file is part of the GNU ISO C++ Library. This library is free
6 // software; you can redistribute it and/or modify it under the terms
7 // of the GNU General Public License as published by the Free Software
8 // Foundation; either version 2, or (at your option) any later
11 // This library is distributed in the hope that it will be useful, but
12 // WITHOUT ANY WARRANTY; without even the implied warranty of
13 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 // General Public License for more details.
16 // You should have received a copy of the GNU General Public License
17 // along with this library; see the file COPYING. If not, write to
18 // the Free Software Foundation, 59 Temple Place - Suite 330, Boston,
19 // MA 02111-1307, USA.
21 // As a special exception, you may use this file as part of a free
22 // software library without restriction. Specifically, if other files
23 // instantiate templates or use macros or inline functions from this
24 // file, or you compile this file and link it with other files to
25 // produce an executable, this file does not by itself cause the
26 // resulting executable to be covered by the GNU General Public
27 // License. This exception does not however invalidate any other
28 // reasons why the executable file might be covered by the GNU General
31 // Copyright (C) 2004 Ami Tavory and Vladimir Dreizin, IBM-HRL.
33 // Permission to use, copy, modify, sell, and distribute this software
34 // is hereby granted without fee, provided that the above copyright
35 // notice appears in all copies, and that both that copyright notice
36 // and this permission notice appear in supporting documentation. None
37 // of the above authors, nor IBM Haifa Research Laboratories, make any
38 // representation about the suitability of this software for any
39 // purpose. It is provided "as is" without express or implied
43 * @file cc_ht_map_.hpp
44 * Contains an implementation class for cc_ht_map_.
49 #include <ext/pb_ds/detail/cond_dealtor.hpp>
50 #include <ext/pb_ds/tag_and_trait.hpp>
51 #include <ext/pb_ds/detail/hash_fn/ranged_hash_fn.hpp>
52 #include <ext/pb_ds/detail/types_traits.hpp>
53 #include <ext/pb_ds/exception.hpp>
54 #include <ext/pb_ds/detail/eq_fn/hash_eq_fn.hpp>
56 #include <ext/pb_ds/detail/debug_map_base.hpp>
58 #ifdef PB_DS_HT_MAP_TRACE_
61 #include <debug/debug.h>
68 #define PB_DS_CLASS_T_DEC \
69 template<typename Key, typename Mapped, typename Hash_Fn, \
70 typename Eq_Fn, typename Allocator, bool Store_Hash, \
71 typename Comb_Hash_Fn, typename Resize_Policy>
73 #ifdef PB_DS_DATA_TRUE_INDICATOR
74 #define PB_DS_CLASS_NAME cc_ht_map_data_
77 #ifdef PB_DS_DATA_FALSE_INDICATOR
78 #define PB_DS_CLASS_NAME cc_ht_map_no_data_
81 #define PB_DS_CLASS_C_DEC \
82 PB_DS_CLASS_NAME<Key, Mapped, Hash_Fn, Eq_Fn, Allocator, \
83 Store_Hash, Comb_Hash_Fn, Resize_Policy>
85 #define PB_DS_HASH_EQ_FN_C_DEC \
86 hash_eq_fn<Key, Eq_Fn, Allocator, Store_Hash>
88 #define PB_DS_RANGED_HASH_FN_C_DEC \
89 ranged_hash_fn<Key, Hash_Fn, Allocator, Comb_Hash_Fn, Store_Hash>
91 #define PB_DS_TYPES_TRAITS_C_DEC \
92 types_traits<Key, Mapped, Allocator, Store_Hash>
95 #define PB_DS_DEBUG_MAP_BASE_C_DEC \
96 debug_map_base<Key, Eq_Fn, typename Allocator::template rebind<Key>::other::const_reference>
99 #ifdef PB_DS_DATA_TRUE_INDICATOR
100 #define PB_DS_V2F(X) (X).first
101 #define PB_DS_V2S(X) (X).second
104 #ifdef PB_DS_DATA_FALSE_INDICATOR
105 #define PB_DS_V2F(X) (X)
106 #define PB_DS_V2S(X) Mapped_Data()
109 // <011i$i0|\|-<|-|4i|\|i|\|g |-|4$|-| 74813.
110 template<typename Key
,
116 typename Comb_Hash_Fn
,
117 typename Resize_Policy
>
118 class PB_DS_CLASS_NAME
:
119 #ifdef _GLIBCXX_DEBUG
120 protected PB_DS_DEBUG_MAP_BASE_C_DEC
,
122 public PB_DS_HASH_EQ_FN_C_DEC
,
123 public Resize_Policy
,
124 public PB_DS_RANGED_HASH_FN_C_DEC
,
125 public PB_DS_TYPES_TRAITS_C_DEC
128 typedef PB_DS_TYPES_TRAITS_C_DEC traits_base
;
129 typedef typename
traits_base::comp_hash comp_hash
;
130 typedef typename
traits_base::value_type value_type_
;
131 typedef typename
traits_base::pointer pointer_
;
132 typedef typename
traits_base::const_pointer const_pointer_
;
133 typedef typename
traits_base::reference reference_
;
134 typedef typename
traits_base::const_reference const_reference_
;
136 struct entry
: public traits_base::stored_value_type
138 typename
Allocator::template rebind
<entry
>::other::pointer m_p_next
;
141 typedef cond_dealtor
<entry
, Allocator
> cond_dealtor_t
;
143 typedef typename
Allocator::template rebind
<entry
>::other entry_allocator
;
144 typedef typename
entry_allocator::pointer entry_pointer
;
145 typedef typename
entry_allocator::const_pointer const_entry_pointer
;
146 typedef typename
entry_allocator::reference entry_reference
;
147 typedef typename
entry_allocator::const_reference const_entry_reference
;
149 typedef typename
Allocator::template rebind
<entry_pointer
>::other entry_pointer_allocator
;
150 typedef typename
entry_pointer_allocator::pointer entry_pointer_array
;
152 typedef PB_DS_RANGED_HASH_FN_C_DEC ranged_hash_fn_base
;
153 typedef PB_DS_HASH_EQ_FN_C_DEC hash_eq_fn_base
;
154 typedef Resize_Policy resize_base
;
156 #ifdef _GLIBCXX_DEBUG
157 typedef PB_DS_DEBUG_MAP_BASE_C_DEC debug_base
;
160 #define PB_DS_GEN_POS std::pair<entry_pointer, typename Allocator::size_type>
162 #include <ext/pb_ds/detail/unordered_iterator/const_point_iterator.hpp>
163 #include <ext/pb_ds/detail/unordered_iterator/point_iterator.hpp>
164 #include <ext/pb_ds/detail/unordered_iterator/const_iterator.hpp>
165 #include <ext/pb_ds/detail/unordered_iterator/iterator.hpp>
170 typedef Allocator allocator
;
171 typedef typename
Allocator::size_type size_type
;
172 typedef typename
Allocator::difference_type difference_type
;
173 typedef Hash_Fn hash_fn
;
175 typedef Comb_Hash_Fn comb_hash_fn
;
176 typedef Resize_Policy resize_policy
;
180 store_hash
= Store_Hash
183 typedef typename
traits_base::key_type key_type
;
184 typedef typename
traits_base::key_pointer key_pointer
;
185 typedef typename
traits_base::const_key_pointer const_key_pointer
;
186 typedef typename
traits_base::key_reference key_reference
;
187 typedef typename
traits_base::const_key_reference const_key_reference
;
188 typedef typename
traits_base::mapped_type mapped_type
;
189 typedef typename
traits_base::mapped_pointer mapped_pointer
;
190 typedef typename
traits_base::const_mapped_pointer const_mapped_pointer
;
191 typedef typename
traits_base::mapped_reference mapped_reference
;
192 typedef typename
traits_base::const_mapped_reference const_mapped_reference
;
193 typedef typename
traits_base::value_type value_type
;
194 typedef typename
traits_base::pointer pointer
;
195 typedef typename
traits_base::const_pointer const_pointer
;
196 typedef typename
traits_base::reference reference
;
197 typedef typename
traits_base::const_reference const_reference
;
199 #ifdef PB_DS_DATA_TRUE_INDICATOR
200 typedef point_iterator_ point_iterator
;
203 #ifdef PB_DS_DATA_FALSE_INDICATOR
204 typedef const_point_iterator_ point_iterator
;
207 typedef const_point_iterator_ const_point_iterator
;
209 #ifdef PB_DS_DATA_TRUE_INDICATOR
210 typedef iterator_ iterator
;
213 #ifdef PB_DS_DATA_FALSE_INDICATOR
214 typedef const_iterator_ iterator
;
217 typedef const_iterator_ const_iterator
;
221 PB_DS_CLASS_NAME(const Hash_Fn
&);
223 PB_DS_CLASS_NAME(const Hash_Fn
&, const Eq_Fn
&);
225 PB_DS_CLASS_NAME(const Hash_Fn
&, const Eq_Fn
&, const Comb_Hash_Fn
&);
227 PB_DS_CLASS_NAME(const Hash_Fn
&, const Eq_Fn
&, const Comb_Hash_Fn
&,
228 const Resize_Policy
&);
230 PB_DS_CLASS_NAME(const PB_DS_CLASS_C_DEC
&);
236 swap(PB_DS_CLASS_C_DEC
&);
238 template<typename It
>
240 copy_from_range(It
, It
);
270 get_comb_hash_fn() const;
276 get_resize_policy() const;
278 inline std::pair
<point_iterator
, bool>
279 insert(const_reference r_val
)
280 { return insert_imp(r_val
, traits_base::m_store_extra_indicator
); }
282 inline mapped_reference
283 operator[](const_key_reference r_key
)
285 #ifdef PB_DS_DATA_TRUE_INDICATOR
286 return (subscript_imp(r_key
, traits_base::m_store_extra_indicator
));
289 return traits_base::s_null_mapped
;
293 inline point_iterator
294 find(const_key_reference
);
296 inline const_point_iterator
297 find(const_key_reference
) const;
299 inline point_iterator
302 inline const_point_iterator
306 erase(const_key_reference
);
308 template<typename Pred
>
318 inline const_iterator
324 inline const_iterator
327 #ifdef _GLIBCXX_DEBUG
329 assert_valid() const;
332 #ifdef PB_DS_HT_MAP_TRACE_
342 do_resize_if_needed();
345 do_resize_if_needed_no_throw();
348 resize_imp(size_type new_size
);
351 do_resize(size_type new_size
);
354 resize_imp_no_exceptions(size_type
, entry_pointer_array
, size_type
);
357 resize_imp_no_exceptions_reassign_pointer(entry_pointer
, entry_pointer_array
, false_type
);
360 resize_imp_no_exceptions_reassign_pointer(entry_pointer
, entry_pointer_array
, true_type
);
363 deallocate_links_in_list(entry_pointer
);
366 get_entry(const_reference
, false_type
);
369 get_entry(const_reference
, true_type
);
372 rels_entry(entry_pointer
);
374 #ifdef PB_DS_DATA_TRUE_INDICATOR
375 inline mapped_reference
376 subscript_imp(const_key_reference r_key
, false_type
)
378 _GLIBCXX_DEBUG_ONLY(assert_valid();)
379 const size_type pos
= ranged_hash_fn_base::operator()(r_key
);
380 entry_pointer p_e
= m_entries
[pos
];
381 resize_base::notify_insert_search_start();
384 && !hash_eq_fn_base::operator()(p_e
->m_value
.first
, r_key
))
386 resize_base::notify_insert_search_collision();
390 resize_base::notify_insert_search_end();
393 _GLIBCXX_DEBUG_ONLY(debug_base::check_key_exists(r_key
);)
394 return (p_e
->m_value
.second
);
397 _GLIBCXX_DEBUG_ONLY(debug_base::check_key_does_not_exist(r_key
);)
398 return insert_new_imp(value_type(r_key
, mapped_type()), pos
)->second
;
401 inline mapped_reference
402 subscript_imp(const_key_reference r_key
, true_type
)
404 _GLIBCXX_DEBUG_ONLY(assert_valid();)
405 comp_hash pos_hash_pair
= ranged_hash_fn_base::operator()(r_key
);
406 entry_pointer p_e
= m_entries
[pos_hash_pair
.first
];
407 resize_base::notify_insert_search_start();
408 while (p_e
!= NULL
&&
409 !hash_eq_fn_base::operator()(p_e
->m_value
.first
, p_e
->m_hash
, r_key
, pos_hash_pair
.second
))
411 resize_base::notify_insert_search_collision();
415 resize_base::notify_insert_search_end();
418 _GLIBCXX_DEBUG_ONLY(debug_base::check_key_exists(r_key
);)
419 return p_e
->m_value
.second
;
422 _GLIBCXX_DEBUG_ONLY(debug_base::check_key_does_not_exist(r_key
);)
423 return insert_new_imp(value_type(r_key
, mapped_type()),
424 pos_hash_pair
)->second
;
428 inline std::pair
<point_iterator
, bool>
429 insert_imp(const_reference
, false_type
);
431 inline std::pair
<point_iterator
, bool>
432 insert_imp(const_reference
, true_type
);
435 insert_new_imp(const_reference r_val
, size_type pos
)
437 if (do_resize_if_needed())
438 pos
= ranged_hash_fn_base::operator()(PB_DS_V2F(r_val
));
440 // Following lines might throw an exception.
441 entry_pointer p_e
= get_entry(r_val
, traits_base::m_no_throw_copies_indicator
);
443 // At this point no exceptions can be thrown.
444 p_e
->m_p_next
= m_entries
[pos
];
445 m_entries
[pos
] = p_e
;
446 resize_base::notify_inserted(++m_num_used_e
);
448 _GLIBCXX_DEBUG_ONLY(debug_base::insert_new(PB_DS_V2F(r_val
));)
449 _GLIBCXX_DEBUG_ONLY(assert_valid();)
450 return &p_e
->m_value
;
454 insert_new_imp(const_reference r_val
, comp_hash
& r_pos_hash_pair
)
456 // Following lines might throw an exception.
457 if (do_resize_if_needed())
458 r_pos_hash_pair
= ranged_hash_fn_base::operator()(PB_DS_V2F(r_val
));
460 entry_pointer p_e
= get_entry(r_val
, traits_base::m_no_throw_copies_indicator
);
462 // At this point no exceptions can be thrown.
463 p_e
->m_hash
= r_pos_hash_pair
.second
;
464 p_e
->m_p_next
= m_entries
[r_pos_hash_pair
.first
];
465 m_entries
[r_pos_hash_pair
.first
] = p_e
;
466 resize_base::notify_inserted(++m_num_used_e
);
467 _GLIBCXX_DEBUG_ONLY(debug_base::insert_new(PB_DS_V2F(r_val
));)
468 _GLIBCXX_DEBUG_ONLY(assert_valid();)
469 return &p_e
->m_value
;
473 find_key_pointer(const_key_reference r_key
, false_type
)
475 entry_pointer p_e
= m_entries
[ranged_hash_fn_base::operator()(r_key
)];
476 resize_base::notify_find_search_start();
477 while (p_e
!= NULL
&&
478 !hash_eq_fn_base::operator()(PB_DS_V2F(p_e
->m_value
), r_key
))
480 resize_base::notify_find_search_collision();
484 resize_base::notify_find_search_end();
486 #ifdef _GLIBCXX_DEBUG
488 debug_base::check_key_does_not_exist(r_key
);
490 debug_base::check_key_exists(r_key
);
492 return &p_e
->m_value
;
496 find_key_pointer(const_key_reference r_key
, true_type
)
498 comp_hash pos_hash_pair
= ranged_hash_fn_base::operator()(r_key
);
499 entry_pointer p_e
= m_entries
[pos_hash_pair
.first
];
500 resize_base::notify_find_search_start();
501 while (p_e
!= NULL
&&
502 !hash_eq_fn_base::operator()(PB_DS_V2F(p_e
->m_value
),
504 r_key
, pos_hash_pair
.second
))
506 resize_base::notify_find_search_collision();
510 resize_base::notify_find_search_end();
512 #ifdef _GLIBCXX_DEBUG
514 debug_base::check_key_does_not_exist(r_key
);
516 debug_base::check_key_exists(r_key
);
518 return &p_e
->m_value
;
522 erase_in_pos_imp(const_key_reference
, size_type
);
525 erase_in_pos_imp(const_key_reference
, const comp_hash
&);
528 erase_entry_pointer(entry_pointer
&);
530 #ifdef PB_DS_DATA_TRUE_INDICATOR
532 inc_it_state(pointer
& r_p_value
,
533 std::pair
<entry_pointer
, size_type
>& r_pos
) const
535 inc_it_state((const_mapped_pointer
& )r_p_value
, r_pos
);
540 inc_it_state(const_pointer
& r_p_value
,
541 std::pair
<entry_pointer
, size_type
>& r_pos
) const
543 _GLIBCXX_DEBUG_ASSERT(r_p_value
!= NULL
);
544 r_pos
.first
= r_pos
.first
->m_p_next
;
545 if (r_pos
.first
!= NULL
)
547 r_p_value
= &r_pos
.first
->m_value
;
551 for (++r_pos
.second
; r_pos
.second
< m_num_e
; ++r_pos
.second
)
552 if (m_entries
[r_pos
.second
] != NULL
)
554 r_pos
.first
= m_entries
[r_pos
.second
];
555 r_p_value
= &r_pos
.first
->m_value
;
562 get_start_it_state(pointer
& r_p_value
,
563 std::pair
<entry_pointer
, size_type
>& r_pos
) const
565 for (r_pos
.second
= 0; r_pos
.second
< m_num_e
; ++r_pos
.second
)
566 if (m_entries
[r_pos
.second
] != NULL
)
568 r_pos
.first
= m_entries
[r_pos
.second
];
569 r_p_value
= &r_pos
.first
->m_value
;
575 #ifdef _GLIBCXX_DEBUG
577 assert_entry_pointer_array_valid(const entry_pointer_array
) const;
580 assert_entry_pointer_valid(const entry_pointer
, true_type
) const;
583 assert_entry_pointer_valid(const entry_pointer
, false_type
) const;
586 #ifdef PB_DS_HT_MAP_TRACE_
588 trace_list(const_entry_pointer
) const;
592 #ifdef PB_DS_DATA_TRUE_INDICATOR
593 friend class iterator_
;
596 friend class const_iterator_
;
598 static entry_allocator s_entry_allocator
;
599 static entry_pointer_allocator s_entry_pointer_allocator
;
600 static iterator s_end_it
;
601 static const_iterator s_const_end_it
;
602 static point_iterator s_find_end_it
;
603 static const_point_iterator s_const_find_end_it
;
606 size_type m_num_used_e
;
607 entry_pointer_array m_entries
;
611 store_hash_ok
= !Store_Hash
612 || !is_same
<Hash_Fn
, __gnu_pbds::null_hash_fn
>::value
615 PB_DS_STATIC_ASSERT(sth
, store_hash_ok
);
618 #include <ext/pb_ds/detail/cc_hash_table_map_/constructor_destructor_fn_imps.hpp>
619 #include <ext/pb_ds/detail/cc_hash_table_map_/entry_list_fn_imps.hpp>
620 #include <ext/pb_ds/detail/cc_hash_table_map_/find_fn_imps.hpp>
621 #include <ext/pb_ds/detail/cc_hash_table_map_/resize_fn_imps.hpp>
622 #include <ext/pb_ds/detail/cc_hash_table_map_/debug_fn_imps.hpp>
623 #include <ext/pb_ds/detail/cc_hash_table_map_/size_fn_imps.hpp>
624 #include <ext/pb_ds/detail/cc_hash_table_map_/policy_access_fn_imps.hpp>
625 #include <ext/pb_ds/detail/cc_hash_table_map_/erase_fn_imps.hpp>
626 #include <ext/pb_ds/detail/cc_hash_table_map_/iterators_fn_imps.hpp>
627 #include <ext/pb_ds/detail/cc_hash_table_map_/insert_fn_imps.hpp>
628 #include <ext/pb_ds/detail/cc_hash_table_map_/trace_fn_imps.hpp>
630 #undef PB_DS_CLASS_T_DEC
631 #undef PB_DS_CLASS_C_DEC
632 #undef PB_DS_HASH_EQ_FN_C_DEC
633 #undef PB_DS_RANGED_HASH_FN_C_DEC
634 #undef PB_DS_TYPES_TRAITS_C_DEC
635 #undef PB_DS_DEBUG_MAP_BASE_C_DEC
636 #undef PB_DS_CLASS_NAME
640 } // namespace detail
641 } // namespace __gnu_pbds