... | ... |
@@ -85,23 +85,31 @@ |
85 | 85 |
/// |
86 | 86 |
/// Constructor. |
87 | 87 |
/// \param map A map that assigns \c int values to keys of type |
88 | 88 |
/// \c Item. It is used internally by the heap implementations to |
89 | 89 |
/// handle the cross references. The assigned value must be |
90 | 90 |
/// \c PRE_HEAP (<tt>-1</tt>) for each item. |
91 |
#ifdef DOXYGEN |
|
91 | 92 |
explicit Heap(ItemIntMap &map) {} |
93 |
#else |
|
94 |
explicit Heap(ItemIntMap&) {} |
|
95 |
#endif |
|
92 | 96 |
|
93 | 97 |
/// \brief Constructor. |
94 | 98 |
/// |
95 | 99 |
/// Constructor. |
96 | 100 |
/// \param map A map that assigns \c int values to keys of type |
97 | 101 |
/// \c Item. It is used internally by the heap implementations to |
98 | 102 |
/// handle the cross references. The assigned value must be |
99 | 103 |
/// \c PRE_HEAP (<tt>-1</tt>) for each item. |
100 | 104 |
/// \param comp The function object used for comparing the priorities. |
105 |
#ifdef DOXYGEN |
|
101 | 106 |
explicit Heap(ItemIntMap &map, const CMP &comp) {} |
107 |
#else |
|
108 |
explicit Heap(ItemIntMap&, const CMP&) {} |
|
109 |
#endif |
|
102 | 110 |
|
103 | 111 |
/// \brief The number of items stored in the heap. |
104 | 112 |
/// |
105 | 113 |
/// This function returns the number of items stored in the heap. |
106 | 114 |
int size() const { return 0; } |
107 | 115 |
|
... | ... |
@@ -123,25 +131,29 @@ |
123 | 131 |
/// |
124 | 132 |
/// This function inserts the given item into the heap with the |
125 | 133 |
/// given priority. |
126 | 134 |
/// \param i The item to insert. |
127 | 135 |
/// \param p The priority of the item. |
128 | 136 |
/// \pre \e i must not be stored in the heap. |
137 |
#ifdef DOXYGEN |
|
129 | 138 |
void push(const Item &i, const Prio &p) {} |
139 |
#else |
|
140 |
void push(const Item&, const Prio&) {} |
|
141 |
#endif |
|
130 | 142 |
|
131 | 143 |
/// \brief Return the item having minimum priority. |
132 | 144 |
/// |
133 | 145 |
/// This function returns the item having minimum priority. |
134 | 146 |
/// \pre The heap must be non-empty. |
135 |
Item top() const {} |
|
147 |
Item top() const { return Item(); } |
|
136 | 148 |
|
137 | 149 |
/// \brief The minimum priority. |
138 | 150 |
/// |
139 | 151 |
/// This function returns the minimum priority. |
140 | 152 |
/// \pre The heap must be non-empty. |
141 |
Prio prio() const {} |
|
153 |
Prio prio() const { return Prio(); } |
|
142 | 154 |
|
143 | 155 |
/// \brief Remove the item having minimum priority. |
144 | 156 |
/// |
145 | 157 |
/// This function removes the item having minimum priority. |
146 | 158 |
/// \pre The heap must be non-empty. |
147 | 159 |
void pop() {} |
... | ... |
@@ -149,66 +161,94 @@ |
149 | 161 |
/// \brief Remove the given item from the heap. |
150 | 162 |
/// |
151 | 163 |
/// This function removes the given item from the heap if it is |
152 | 164 |
/// already stored. |
153 | 165 |
/// \param i The item to delete. |
154 | 166 |
/// \pre \e i must be in the heap. |
167 |
#ifdef DOXYGEN |
|
155 | 168 |
void erase(const Item &i) {} |
169 |
#else |
|
170 |
void erase(const Item&) {} |
|
171 |
#endif |
|
156 | 172 |
|
157 | 173 |
/// \brief The priority of the given item. |
158 | 174 |
/// |
159 | 175 |
/// This function returns the priority of the given item. |
160 | 176 |
/// \param i The item. |
161 | 177 |
/// \pre \e i must be in the heap. |
178 |
#ifdef DOXYGEN |
|
162 | 179 |
Prio operator[](const Item &i) const {} |
180 |
#else |
|
181 |
Prio operator[](const Item&) const { return Prio(); } |
|
182 |
#endif |
|
163 | 183 |
|
164 | 184 |
/// \brief Set the priority of an item or insert it, if it is |
165 | 185 |
/// not stored in the heap. |
166 | 186 |
/// |
167 | 187 |
/// This method sets the priority of the given item if it is |
168 | 188 |
/// already stored in the heap. Otherwise it inserts the given |
169 | 189 |
/// item into the heap with the given priority. |
170 | 190 |
/// |
171 | 191 |
/// \param i The item. |
172 | 192 |
/// \param p The priority. |
193 |
#ifdef DOXYGEN |
|
173 | 194 |
void set(const Item &i, const Prio &p) {} |
195 |
#else |
|
196 |
void set(const Item&, const Prio&) {} |
|
197 |
#endif |
|
174 | 198 |
|
175 | 199 |
/// \brief Decrease the priority of an item to the given value. |
176 | 200 |
/// |
177 | 201 |
/// This function decreases the priority of an item to the given value. |
178 | 202 |
/// \param i The item. |
179 | 203 |
/// \param p The priority. |
180 | 204 |
/// \pre \e i must be stored in the heap with priority at least \e p. |
205 |
#ifdef DOXYGEN |
|
181 | 206 |
void decrease(const Item &i, const Prio &p) {} |
207 |
#else |
|
208 |
void decrease(const Item&, const Prio&) {} |
|
209 |
#endif |
|
182 | 210 |
|
183 | 211 |
/// \brief Increase the priority of an item to the given value. |
184 | 212 |
/// |
185 | 213 |
/// This function increases the priority of an item to the given value. |
186 | 214 |
/// \param i The item. |
187 | 215 |
/// \param p The priority. |
188 | 216 |
/// \pre \e i must be stored in the heap with priority at most \e p. |
217 |
#ifdef DOXYGEN |
|
189 | 218 |
void increase(const Item &i, const Prio &p) {} |
219 |
#else |
|
220 |
void increase(const Item&, const Prio&) {} |
|
221 |
#endif |
|
190 | 222 |
|
191 | 223 |
/// \brief Return the state of an item. |
192 | 224 |
/// |
193 | 225 |
/// This method returns \c PRE_HEAP if the given item has never |
194 | 226 |
/// been in the heap, \c IN_HEAP if it is in the heap at the moment, |
195 | 227 |
/// and \c POST_HEAP otherwise. |
196 | 228 |
/// In the latter case it is possible that the item will get back |
197 | 229 |
/// to the heap again. |
198 | 230 |
/// \param i The item. |
231 |
#ifdef DOXYGEN |
|
199 | 232 |
State state(const Item &i) const {} |
233 |
#else |
|
234 |
State state(const Item&) const { return PRE_HEAP; } |
|
235 |
#endif |
|
200 | 236 |
|
201 | 237 |
/// \brief Set the state of an item in the heap. |
202 | 238 |
/// |
203 | 239 |
/// This function sets the state of the given item in the heap. |
204 | 240 |
/// It can be used to manually clear the heap when it is important |
205 | 241 |
/// to achive better time complexity. |
206 | 242 |
/// \param i The item. |
207 | 243 |
/// \param st The state. It should not be \c IN_HEAP. |
244 |
#ifdef DOXYGEN |
|
208 | 245 |
void state(const Item& i, State st) {} |
246 |
#else |
|
247 |
void state(const Item&, State) {} |
|
248 |
#endif |
|
209 | 249 |
|
210 | 250 |
|
211 | 251 |
template <typename _Heap> |
212 | 252 |
struct Constraints { |
213 | 253 |
public: |
214 | 254 |
void constraints() { |
0 comments (0 inline)