libstdc++
rc_binomial_heap_.hpp
Go to the documentation of this file.
1 // -*- C++ -*-
2 
3 // Copyright (C) 2005-2014 Free Software Foundation, Inc.
4 //
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 3, or (at your option) any later
9 // version.
10 
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.
15 
16 // Under Section 7 of GPL version 3, you are granted additional
17 // permissions described in the GCC Runtime Library Exception, version
18 // 3.1, as published by the Free Software Foundation.
19 
20 // You should have received a copy of the GNU General Public License and
21 // a copy of the GCC Runtime Library Exception along with this program;
22 // see the files COPYING3 and COPYING.RUNTIME respectively. If not, see
23 // <http://www.gnu.org/licenses/>.
24 
25 // Copyright (C) 2004 Ami Tavory and Vladimir Dreizin, IBM-HRL.
26 
27 // Permission to use, copy, modify, sell, and distribute this software
28 // is hereby granted without fee, provided that the above copyright
29 // notice appears in all copies, and that both that copyright notice
30 // and this permission notice appear in supporting documentation. None
31 // of the above authors, nor IBM Haifa Research Laboratories, make any
32 // representation about the suitability of this software for any
33 // purpose. It is provided "as is" without express or implied
34 // warranty.
35 
36 /**
37  * @file rc_binomial_heap_/rc_binomial_heap_.hpp
38  * Contains an implementation for redundant-counter binomial heap.
39  */
40 
45 #include <debug/debug.h>
46 
47 namespace __gnu_pbds
48 {
49  namespace detail
50  {
51 #define PB_DS_CLASS_T_DEC \
52  template<typename Value_Type, typename Cmp_Fn, typename _Alloc>
53 
54 #define PB_DS_CLASS_C_DEC \
55  rc_binomial_heap<Value_Type, Cmp_Fn, _Alloc>
56 
57 #define PB_DS_RC_C_DEC \
58  rc<typename binomial_heap_base<Value_Type, Cmp_Fn, _Alloc>::node, _Alloc>
59 
60  /**
61  * Redundant-counter binomial heap.
62  *
63  * @ingroup heap-detail
64  */
65  template<typename Value_Type, typename Cmp_Fn, typename _Alloc>
67  : public binomial_heap_base<Value_Type, Cmp_Fn, _Alloc>
68  {
69  private:
71  base_type;
72  typedef typename base_type::node_pointer node_pointer;
73  typedef typename base_type::node_const_pointer node_const_pointer;
74  typedef PB_DS_RC_C_DEC rc_t;
75 
76  public:
77  typedef Value_Type value_type;
78  typedef typename _Alloc::size_type size_type;
79  typedef typename _Alloc::difference_type difference_type;
80  typedef typename base_type::pointer pointer;
81  typedef typename base_type::const_pointer const_pointer;
82  typedef typename base_type::reference reference;
83  typedef typename base_type::const_reference const_reference;
87  typedef typename base_type::iterator iterator;
88  typedef typename base_type::cmp_fn cmp_fn;
89  typedef typename base_type::allocator_type allocator_type;
90 
92 
93  rc_binomial_heap(const Cmp_Fn&);
94 
95  rc_binomial_heap(const PB_DS_CLASS_C_DEC&);
96 
98 
99  void
100  swap(PB_DS_CLASS_C_DEC&);
101 
102  inline point_iterator
103  push(const_reference);
104 
105  void
106  modify(point_iterator, const_reference);
107 
108  inline void
109  pop();
110 
111  void
112  erase(point_iterator);
113 
114  inline void
115  clear();
116 
117  template<typename Pred>
118  size_type
119  erase_if(Pred);
120 
121  template<typename Pred>
122  void
123  split(Pred, PB_DS_CLASS_C_DEC&);
124 
125  void
126  join(PB_DS_CLASS_C_DEC&);
127 
128 #ifdef _GLIBCXX_DEBUG
129  void
130  assert_valid(const char*, int) const;
131 #endif
132 
133 #ifdef PB_DS_RC_BINOMIAL_HEAP_TRACE_
134  void
135  trace() const;
136 #endif
137 
138  private:
139 
140  inline node_pointer
141  link_with_next_sibling(node_pointer);
142 
143  void
144  make_0_exposed();
145 
146  void
147  make_binomial_heap();
148 
149 #ifdef _GLIBCXX_DEBUG
150  static node_const_pointer
151  next_2_pointer(node_const_pointer);
152 
153  static node_const_pointer
154  next_after_0_pointer(node_const_pointer);
155 #endif
156 
157  rc_t m_rc;
158  };
159 
166 
167 #undef PB_DS_CLASS_C_DEC
168 #undef PB_DS_CLASS_T_DEC
169 #undef PB_DS_RC_C_DEC
170  } // namespace detail
171 } // namespace __gnu_pbds