1 | // Queue implementation -*- C++ -*-
|
---|
2 |
|
---|
3 | // Copyright (C) 2001-2021 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
|
---|
7 | // terms of the GNU General Public License as published by the
|
---|
8 | // Free Software Foundation; either version 3, or (at your option)
|
---|
9 | // any later version.
|
---|
10 |
|
---|
11 | // This library is distributed in the hope that it will be useful,
|
---|
12 | // but WITHOUT ANY WARRANTY; without even the implied warranty of
|
---|
13 | // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
---|
14 | // GNU 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 | /*
|
---|
26 | *
|
---|
27 | * Copyright (c) 1994
|
---|
28 | * Hewlett-Packard Company
|
---|
29 | *
|
---|
30 | * Permission to use, copy, modify, distribute and sell this software
|
---|
31 | * and its documentation for any purpose is hereby granted without fee,
|
---|
32 | * provided that the above copyright notice appear in all copies and
|
---|
33 | * that both that copyright notice and this permission notice appear
|
---|
34 | * in supporting documentation. Hewlett-Packard Company makes no
|
---|
35 | * representations about the suitability of this software for any
|
---|
36 | * purpose. It is provided "as is" without express or implied warranty.
|
---|
37 | *
|
---|
38 | *
|
---|
39 | * Copyright (c) 1996,1997
|
---|
40 | * Silicon Graphics Computer Systems, Inc.
|
---|
41 | *
|
---|
42 | * Permission to use, copy, modify, distribute and sell this software
|
---|
43 | * and its documentation for any purpose is hereby granted without fee,
|
---|
44 | * provided that the above copyright notice appear in all copies and
|
---|
45 | * that both that copyright notice and this permission notice appear
|
---|
46 | * in supporting documentation. Silicon Graphics makes no
|
---|
47 | * representations about the suitability of this software for any
|
---|
48 | * purpose. It is provided "as is" without express or implied warranty.
|
---|
49 | */
|
---|
50 |
|
---|
51 | /** @file bits/stl_queue.h
|
---|
52 | * This is an internal header file, included by other library headers.
|
---|
53 | * Do not attempt to use it directly. @headername{queue}
|
---|
54 | */
|
---|
55 |
|
---|
56 | #ifndef _STL_QUEUE_H
|
---|
57 | #define _STL_QUEUE_H 1
|
---|
58 |
|
---|
59 | #include <bits/concept_check.h>
|
---|
60 | #include <debug/debug.h>
|
---|
61 | #if __cplusplus >= 201103L
|
---|
62 | # include <bits/uses_allocator.h>
|
---|
63 | #endif
|
---|
64 |
|
---|
65 | namespace std _GLIBCXX_VISIBILITY(default)
|
---|
66 | {
|
---|
67 | _GLIBCXX_BEGIN_NAMESPACE_VERSION
|
---|
68 |
|
---|
69 | /**
|
---|
70 | * @brief A standard container giving FIFO behavior.
|
---|
71 | *
|
---|
72 | * @ingroup sequences
|
---|
73 | *
|
---|
74 | * @tparam _Tp Type of element.
|
---|
75 | * @tparam _Sequence Type of underlying sequence, defaults to deque<_Tp>.
|
---|
76 | *
|
---|
77 | * Meets many of the requirements of a
|
---|
78 | * <a href="tables.html#65">container</a>,
|
---|
79 | * but does not define anything to do with iterators. Very few of the
|
---|
80 | * other standard container interfaces are defined.
|
---|
81 | *
|
---|
82 | * This is not a true container, but an @e adaptor. It holds another
|
---|
83 | * container, and provides a wrapper interface to that container. The
|
---|
84 | * wrapper is what enforces strict first-in-first-out %queue behavior.
|
---|
85 | *
|
---|
86 | * The second template parameter defines the type of the underlying
|
---|
87 | * sequence/container. It defaults to std::deque, but it can be any type
|
---|
88 | * that supports @c front, @c back, @c push_back, and @c pop_front,
|
---|
89 | * such as std::list or an appropriate user-defined type.
|
---|
90 | *
|
---|
91 | * Members not found in @a normal containers are @c container_type,
|
---|
92 | * which is a typedef for the second Sequence parameter, and @c push and
|
---|
93 | * @c pop, which are standard %queue/FIFO operations.
|
---|
94 | */
|
---|
95 | template<typename _Tp, typename _Sequence = deque<_Tp> >
|
---|
96 | class queue
|
---|
97 | {
|
---|
98 | #ifdef _GLIBCXX_CONCEPT_CHECKS
|
---|
99 | // concept requirements
|
---|
100 | typedef typename _Sequence::value_type _Sequence_value_type;
|
---|
101 | # if __cplusplus < 201103L
|
---|
102 | __glibcxx_class_requires(_Tp, _SGIAssignableConcept)
|
---|
103 | # endif
|
---|
104 | __glibcxx_class_requires(_Sequence, _FrontInsertionSequenceConcept)
|
---|
105 | __glibcxx_class_requires(_Sequence, _BackInsertionSequenceConcept)
|
---|
106 | __glibcxx_class_requires2(_Tp, _Sequence_value_type, _SameTypeConcept)
|
---|
107 | #endif
|
---|
108 |
|
---|
109 | template<typename _Tp1, typename _Seq1>
|
---|
110 | friend bool
|
---|
111 | operator==(const queue<_Tp1, _Seq1>&, const queue<_Tp1, _Seq1>&);
|
---|
112 |
|
---|
113 | template<typename _Tp1, typename _Seq1>
|
---|
114 | friend bool
|
---|
115 | operator<(const queue<_Tp1, _Seq1>&, const queue<_Tp1, _Seq1>&);
|
---|
116 |
|
---|
117 | #if __cpp_lib_three_way_comparison
|
---|
118 | template<typename _Tp1, three_way_comparable _Seq1>
|
---|
119 | friend compare_three_way_result_t<_Seq1>
|
---|
120 | operator<=>(const queue<_Tp1, _Seq1>&, const queue<_Tp1, _Seq1>&);
|
---|
121 | #endif
|
---|
122 |
|
---|
123 | #if __cplusplus >= 201103L
|
---|
124 | template<typename _Alloc>
|
---|
125 | using _Uses = typename
|
---|
126 | enable_if<uses_allocator<_Sequence, _Alloc>::value>::type;
|
---|
127 |
|
---|
128 | #if __cplusplus >= 201703L
|
---|
129 | // _GLIBCXX_RESOLVE_LIB_DEFECTS
|
---|
130 | // 2566. Requirements on the first template parameter of container
|
---|
131 | // adaptors
|
---|
132 | static_assert(is_same<_Tp, typename _Sequence::value_type>::value,
|
---|
133 | "value_type must be the same as the underlying container");
|
---|
134 | #endif // C++17
|
---|
135 | #endif // C++11
|
---|
136 |
|
---|
137 | public:
|
---|
138 | typedef typename _Sequence::value_type value_type;
|
---|
139 | typedef typename _Sequence::reference reference;
|
---|
140 | typedef typename _Sequence::const_reference const_reference;
|
---|
141 | typedef typename _Sequence::size_type size_type;
|
---|
142 | typedef _Sequence container_type;
|
---|
143 |
|
---|
144 | protected:
|
---|
145 | /* Maintainers wondering why this isn't uglified as per style
|
---|
146 | * guidelines should note that this name is specified in the standard,
|
---|
147 | * C++98 [23.2.3.1].
|
---|
148 | * (Why? Presumably for the same reason that it's protected instead
|
---|
149 | * of private: to allow derivation. But none of the other
|
---|
150 | * containers allow for derivation. Odd.)
|
---|
151 | */
|
---|
152 | /// @c c is the underlying container.
|
---|
153 | _Sequence c;
|
---|
154 |
|
---|
155 | public:
|
---|
156 | /**
|
---|
157 | * @brief Default constructor creates no elements.
|
---|
158 | */
|
---|
159 | #if __cplusplus < 201103L
|
---|
160 | explicit
|
---|
161 | queue(const _Sequence& __c = _Sequence())
|
---|
162 | : c(__c) { }
|
---|
163 | #else
|
---|
164 | template<typename _Seq = _Sequence, typename _Requires = typename
|
---|
165 | enable_if<is_default_constructible<_Seq>::value>::type>
|
---|
166 | queue()
|
---|
167 | : c() { }
|
---|
168 |
|
---|
169 | explicit
|
---|
170 | queue(const _Sequence& __c)
|
---|
171 | : c(__c) { }
|
---|
172 |
|
---|
173 | explicit
|
---|
174 | queue(_Sequence&& __c)
|
---|
175 | : c(std::move(__c)) { }
|
---|
176 |
|
---|
177 | template<typename _Alloc, typename _Requires = _Uses<_Alloc>>
|
---|
178 | explicit
|
---|
179 | queue(const _Alloc& __a)
|
---|
180 | : c(__a) { }
|
---|
181 |
|
---|
182 | template<typename _Alloc, typename _Requires = _Uses<_Alloc>>
|
---|
183 | queue(const _Sequence& __c, const _Alloc& __a)
|
---|
184 | : c(__c, __a) { }
|
---|
185 |
|
---|
186 | template<typename _Alloc, typename _Requires = _Uses<_Alloc>>
|
---|
187 | queue(_Sequence&& __c, const _Alloc& __a)
|
---|
188 | : c(std::move(__c), __a) { }
|
---|
189 |
|
---|
190 | template<typename _Alloc, typename _Requires = _Uses<_Alloc>>
|
---|
191 | queue(const queue& __q, const _Alloc& __a)
|
---|
192 | : c(__q.c, __a) { }
|
---|
193 |
|
---|
194 | template<typename _Alloc, typename _Requires = _Uses<_Alloc>>
|
---|
195 | queue(queue&& __q, const _Alloc& __a)
|
---|
196 | : c(std::move(__q.c), __a) { }
|
---|
197 | #endif
|
---|
198 |
|
---|
199 | /**
|
---|
200 | * Returns true if the %queue is empty.
|
---|
201 | */
|
---|
202 | _GLIBCXX_NODISCARD bool
|
---|
203 | empty() const
|
---|
204 | { return c.empty(); }
|
---|
205 |
|
---|
206 | /** Returns the number of elements in the %queue. */
|
---|
207 | size_type
|
---|
208 | size() const
|
---|
209 | { return c.size(); }
|
---|
210 |
|
---|
211 | /**
|
---|
212 | * Returns a read/write reference to the data at the first
|
---|
213 | * element of the %queue.
|
---|
214 | */
|
---|
215 | reference
|
---|
216 | front()
|
---|
217 | {
|
---|
218 | __glibcxx_requires_nonempty();
|
---|
219 | return c.front();
|
---|
220 | }
|
---|
221 |
|
---|
222 | /**
|
---|
223 | * Returns a read-only (constant) reference to the data at the first
|
---|
224 | * element of the %queue.
|
---|
225 | */
|
---|
226 | const_reference
|
---|
227 | front() const
|
---|
228 | {
|
---|
229 | __glibcxx_requires_nonempty();
|
---|
230 | return c.front();
|
---|
231 | }
|
---|
232 |
|
---|
233 | /**
|
---|
234 | * Returns a read/write reference to the data at the last
|
---|
235 | * element of the %queue.
|
---|
236 | */
|
---|
237 | reference
|
---|
238 | back()
|
---|
239 | {
|
---|
240 | __glibcxx_requires_nonempty();
|
---|
241 | return c.back();
|
---|
242 | }
|
---|
243 |
|
---|
244 | /**
|
---|
245 | * Returns a read-only (constant) reference to the data at the last
|
---|
246 | * element of the %queue.
|
---|
247 | */
|
---|
248 | const_reference
|
---|
249 | back() const
|
---|
250 | {
|
---|
251 | __glibcxx_requires_nonempty();
|
---|
252 | return c.back();
|
---|
253 | }
|
---|
254 |
|
---|
255 | /**
|
---|
256 | * @brief Add data to the end of the %queue.
|
---|
257 | * @param __x Data to be added.
|
---|
258 | *
|
---|
259 | * This is a typical %queue operation. The function creates an
|
---|
260 | * element at the end of the %queue and assigns the given data
|
---|
261 | * to it. The time complexity of the operation depends on the
|
---|
262 | * underlying sequence.
|
---|
263 | */
|
---|
264 | void
|
---|
265 | push(const value_type& __x)
|
---|
266 | { c.push_back(__x); }
|
---|
267 |
|
---|
268 | #if __cplusplus >= 201103L
|
---|
269 | void
|
---|
270 | push(value_type&& __x)
|
---|
271 | { c.push_back(std::move(__x)); }
|
---|
272 |
|
---|
273 | #if __cplusplus > 201402L
|
---|
274 | template<typename... _Args>
|
---|
275 | decltype(auto)
|
---|
276 | emplace(_Args&&... __args)
|
---|
277 | { return c.emplace_back(std::forward<_Args>(__args)...); }
|
---|
278 | #else
|
---|
279 | template<typename... _Args>
|
---|
280 | void
|
---|
281 | emplace(_Args&&... __args)
|
---|
282 | { c.emplace_back(std::forward<_Args>(__args)...); }
|
---|
283 | #endif
|
---|
284 | #endif
|
---|
285 |
|
---|
286 | /**
|
---|
287 | * @brief Removes first element.
|
---|
288 | *
|
---|
289 | * This is a typical %queue operation. It shrinks the %queue by one.
|
---|
290 | * The time complexity of the operation depends on the underlying
|
---|
291 | * sequence.
|
---|
292 | *
|
---|
293 | * Note that no data is returned, and if the first element's
|
---|
294 | * data is needed, it should be retrieved before pop() is
|
---|
295 | * called.
|
---|
296 | */
|
---|
297 | void
|
---|
298 | pop()
|
---|
299 | {
|
---|
300 | __glibcxx_requires_nonempty();
|
---|
301 | c.pop_front();
|
---|
302 | }
|
---|
303 |
|
---|
304 | #if __cplusplus >= 201103L
|
---|
305 | void
|
---|
306 | swap(queue& __q)
|
---|
307 | #if __cplusplus > 201402L || !defined(__STRICT_ANSI__) // c++1z or gnu++11
|
---|
308 | noexcept(__is_nothrow_swappable<_Sequence>::value)
|
---|
309 | #else
|
---|
310 | noexcept(__is_nothrow_swappable<_Tp>::value)
|
---|
311 | #endif
|
---|
312 | {
|
---|
313 | using std::swap;
|
---|
314 | swap(c, __q.c);
|
---|
315 | }
|
---|
316 | #endif // __cplusplus >= 201103L
|
---|
317 | };
|
---|
318 |
|
---|
319 | #if __cpp_deduction_guides >= 201606
|
---|
320 | template<typename _Container,
|
---|
321 | typename = _RequireNotAllocator<_Container>>
|
---|
322 | queue(_Container) -> queue<typename _Container::value_type, _Container>;
|
---|
323 |
|
---|
324 | template<typename _Container, typename _Allocator,
|
---|
325 | typename = _RequireNotAllocator<_Container>,
|
---|
326 | typename = _RequireAllocator<_Allocator>>
|
---|
327 | queue(_Container, _Allocator)
|
---|
328 | -> queue<typename _Container::value_type, _Container>;
|
---|
329 | #endif
|
---|
330 |
|
---|
331 | /**
|
---|
332 | * @brief Queue equality comparison.
|
---|
333 | * @param __x A %queue.
|
---|
334 | * @param __y A %queue of the same type as @a __x.
|
---|
335 | * @return True iff the size and elements of the queues are equal.
|
---|
336 | *
|
---|
337 | * This is an equivalence relation. Complexity and semantics depend on the
|
---|
338 | * underlying sequence type, but the expected rules are: this relation is
|
---|
339 | * linear in the size of the sequences, and queues are considered equivalent
|
---|
340 | * if their sequences compare equal.
|
---|
341 | */
|
---|
342 | template<typename _Tp, typename _Seq>
|
---|
343 | inline bool
|
---|
344 | operator==(const queue<_Tp, _Seq>& __x, const queue<_Tp, _Seq>& __y)
|
---|
345 | { return __x.c == __y.c; }
|
---|
346 |
|
---|
347 | /**
|
---|
348 | * @brief Queue ordering relation.
|
---|
349 | * @param __x A %queue.
|
---|
350 | * @param __y A %queue of the same type as @a x.
|
---|
351 | * @return True iff @a __x is lexicographically less than @a __y.
|
---|
352 | *
|
---|
353 | * This is an total ordering relation. Complexity and semantics
|
---|
354 | * depend on the underlying sequence type, but the expected rules
|
---|
355 | * are: this relation is linear in the size of the sequences, the
|
---|
356 | * elements must be comparable with @c <, and
|
---|
357 | * std::lexicographical_compare() is usually used to make the
|
---|
358 | * determination.
|
---|
359 | */
|
---|
360 | template<typename _Tp, typename _Seq>
|
---|
361 | inline bool
|
---|
362 | operator<(const queue<_Tp, _Seq>& __x, const queue<_Tp, _Seq>& __y)
|
---|
363 | { return __x.c < __y.c; }
|
---|
364 |
|
---|
365 | /// Based on operator==
|
---|
366 | template<typename _Tp, typename _Seq>
|
---|
367 | inline bool
|
---|
368 | operator!=(const queue<_Tp, _Seq>& __x, const queue<_Tp, _Seq>& __y)
|
---|
369 | { return !(__x == __y); }
|
---|
370 |
|
---|
371 | /// Based on operator<
|
---|
372 | template<typename _Tp, typename _Seq>
|
---|
373 | inline bool
|
---|
374 | operator>(const queue<_Tp, _Seq>& __x, const queue<_Tp, _Seq>& __y)
|
---|
375 | { return __y < __x; }
|
---|
376 |
|
---|
377 | /// Based on operator<
|
---|
378 | template<typename _Tp, typename _Seq>
|
---|
379 | inline bool
|
---|
380 | operator<=(const queue<_Tp, _Seq>& __x, const queue<_Tp, _Seq>& __y)
|
---|
381 | { return !(__y < __x); }
|
---|
382 |
|
---|
383 | /// Based on operator<
|
---|
384 | template<typename _Tp, typename _Seq>
|
---|
385 | inline bool
|
---|
386 | operator>=(const queue<_Tp, _Seq>& __x, const queue<_Tp, _Seq>& __y)
|
---|
387 | { return !(__x < __y); }
|
---|
388 |
|
---|
389 | #if __cpp_lib_three_way_comparison
|
---|
390 | template<typename _Tp, three_way_comparable _Seq>
|
---|
391 | inline compare_three_way_result_t<_Seq>
|
---|
392 | operator<=>(const queue<_Tp, _Seq>& __x, const queue<_Tp, _Seq>& __y)
|
---|
393 | { return __x.c <=> __y.c; }
|
---|
394 | #endif
|
---|
395 |
|
---|
396 | #if __cplusplus >= 201103L
|
---|
397 | template<typename _Tp, typename _Seq>
|
---|
398 | inline
|
---|
399 | #if __cplusplus > 201402L || !defined(__STRICT_ANSI__) // c++1z or gnu++11
|
---|
400 | // Constrained free swap overload, see p0185r1
|
---|
401 | typename enable_if<__is_swappable<_Seq>::value>::type
|
---|
402 | #else
|
---|
403 | void
|
---|
404 | #endif
|
---|
405 | swap(queue<_Tp, _Seq>& __x, queue<_Tp, _Seq>& __y)
|
---|
406 | noexcept(noexcept(__x.swap(__y)))
|
---|
407 | { __x.swap(__y); }
|
---|
408 |
|
---|
409 | template<typename _Tp, typename _Seq, typename _Alloc>
|
---|
410 | struct uses_allocator<queue<_Tp, _Seq>, _Alloc>
|
---|
411 | : public uses_allocator<_Seq, _Alloc>::type { };
|
---|
412 | #endif // __cplusplus >= 201103L
|
---|
413 |
|
---|
414 | /**
|
---|
415 | * @brief A standard container automatically sorting its contents.
|
---|
416 | *
|
---|
417 | * @ingroup sequences
|
---|
418 | *
|
---|
419 | * @tparam _Tp Type of element.
|
---|
420 | * @tparam _Sequence Type of underlying sequence, defaults to vector<_Tp>.
|
---|
421 | * @tparam _Compare Comparison function object type, defaults to
|
---|
422 | * less<_Sequence::value_type>.
|
---|
423 | *
|
---|
424 | * This is not a true container, but an @e adaptor. It holds
|
---|
425 | * another container, and provides a wrapper interface to that
|
---|
426 | * container. The wrapper is what enforces priority-based sorting
|
---|
427 | * and %queue behavior. Very few of the standard container/sequence
|
---|
428 | * interface requirements are met (e.g., iterators).
|
---|
429 | *
|
---|
430 | * The second template parameter defines the type of the underlying
|
---|
431 | * sequence/container. It defaults to std::vector, but it can be
|
---|
432 | * any type that supports @c front(), @c push_back, @c pop_back,
|
---|
433 | * and random-access iterators, such as std::deque or an
|
---|
434 | * appropriate user-defined type.
|
---|
435 | *
|
---|
436 | * The third template parameter supplies the means of making
|
---|
437 | * priority comparisons. It defaults to @c less<value_type> but
|
---|
438 | * can be anything defining a strict weak ordering.
|
---|
439 | *
|
---|
440 | * Members not found in @a normal containers are @c container_type,
|
---|
441 | * which is a typedef for the second Sequence parameter, and @c
|
---|
442 | * push, @c pop, and @c top, which are standard %queue operations.
|
---|
443 | *
|
---|
444 | * @note No equality/comparison operators are provided for
|
---|
445 | * %priority_queue.
|
---|
446 | *
|
---|
447 | * @note Sorting of the elements takes place as they are added to,
|
---|
448 | * and removed from, the %priority_queue using the
|
---|
449 | * %priority_queue's member functions. If you access the elements
|
---|
450 | * by other means, and change their data such that the sorting
|
---|
451 | * order would be different, the %priority_queue will not re-sort
|
---|
452 | * the elements for you. (How could it know to do so?)
|
---|
453 | */
|
---|
454 | template<typename _Tp, typename _Sequence = vector<_Tp>,
|
---|
455 | typename _Compare = less<typename _Sequence::value_type> >
|
---|
456 | class priority_queue
|
---|
457 | {
|
---|
458 | #ifdef _GLIBCXX_CONCEPT_CHECKS
|
---|
459 | // concept requirements
|
---|
460 | typedef typename _Sequence::value_type _Sequence_value_type;
|
---|
461 | # if __cplusplus < 201103L
|
---|
462 | __glibcxx_class_requires(_Tp, _SGIAssignableConcept)
|
---|
463 | # endif
|
---|
464 | __glibcxx_class_requires(_Sequence, _SequenceConcept)
|
---|
465 | __glibcxx_class_requires(_Sequence, _RandomAccessContainerConcept)
|
---|
466 | __glibcxx_class_requires2(_Tp, _Sequence_value_type, _SameTypeConcept)
|
---|
467 | __glibcxx_class_requires4(_Compare, bool, _Tp, _Tp,
|
---|
468 | _BinaryFunctionConcept)
|
---|
469 | #endif
|
---|
470 |
|
---|
471 | #if __cplusplus >= 201103L
|
---|
472 | template<typename _Alloc>
|
---|
473 | using _Uses = typename
|
---|
474 | enable_if<uses_allocator<_Sequence, _Alloc>::value>::type;
|
---|
475 |
|
---|
476 | #if __cplusplus >= 201703L
|
---|
477 | // _GLIBCXX_RESOLVE_LIB_DEFECTS
|
---|
478 | // 2566. Requirements on the first template parameter of container
|
---|
479 | // adaptors
|
---|
480 | static_assert(is_same<_Tp, typename _Sequence::value_type>::value,
|
---|
481 | "value_type must be the same as the underlying container");
|
---|
482 | #endif // C++17
|
---|
483 | #endif // C++11
|
---|
484 |
|
---|
485 | public:
|
---|
486 | typedef typename _Sequence::value_type value_type;
|
---|
487 | typedef typename _Sequence::reference reference;
|
---|
488 | typedef typename _Sequence::const_reference const_reference;
|
---|
489 | typedef typename _Sequence::size_type size_type;
|
---|
490 | typedef _Sequence container_type;
|
---|
491 | // _GLIBCXX_RESOLVE_LIB_DEFECTS
|
---|
492 | // DR 2684. priority_queue lacking comparator typedef
|
---|
493 | typedef _Compare value_compare;
|
---|
494 |
|
---|
495 | protected:
|
---|
496 | // See queue::c for notes on these names.
|
---|
497 | _Sequence c;
|
---|
498 | _Compare comp;
|
---|
499 |
|
---|
500 | public:
|
---|
501 | /**
|
---|
502 | * @brief Default constructor creates no elements.
|
---|
503 | */
|
---|
504 | #if __cplusplus < 201103L
|
---|
505 | explicit
|
---|
506 | priority_queue(const _Compare& __x = _Compare(),
|
---|
507 | const _Sequence& __s = _Sequence())
|
---|
508 | : c(__s), comp(__x)
|
---|
509 | { std::make_heap(c.begin(), c.end(), comp); }
|
---|
510 | #else
|
---|
511 | template<typename _Seq = _Sequence, typename _Requires = typename
|
---|
512 | enable_if<__and_<is_default_constructible<_Compare>,
|
---|
513 | is_default_constructible<_Seq>>::value>::type>
|
---|
514 | priority_queue()
|
---|
515 | : c(), comp() { }
|
---|
516 |
|
---|
517 | explicit
|
---|
518 | priority_queue(const _Compare& __x, const _Sequence& __s)
|
---|
519 | : c(__s), comp(__x)
|
---|
520 | { std::make_heap(c.begin(), c.end(), comp); }
|
---|
521 |
|
---|
522 | explicit
|
---|
523 | priority_queue(const _Compare& __x, _Sequence&& __s = _Sequence())
|
---|
524 | : c(std::move(__s)), comp(__x)
|
---|
525 | { std::make_heap(c.begin(), c.end(), comp); }
|
---|
526 |
|
---|
527 | template<typename _Alloc, typename _Requires = _Uses<_Alloc>>
|
---|
528 | explicit
|
---|
529 | priority_queue(const _Alloc& __a)
|
---|
530 | : c(__a), comp() { }
|
---|
531 |
|
---|
532 | template<typename _Alloc, typename _Requires = _Uses<_Alloc>>
|
---|
533 | priority_queue(const _Compare& __x, const _Alloc& __a)
|
---|
534 | : c(__a), comp(__x) { }
|
---|
535 |
|
---|
536 | // _GLIBCXX_RESOLVE_LIB_DEFECTS
|
---|
537 | // 2537. Constructors [...] taking allocators should call make_heap
|
---|
538 | template<typename _Alloc, typename _Requires = _Uses<_Alloc>>
|
---|
539 | priority_queue(const _Compare& __x, const _Sequence& __c,
|
---|
540 | const _Alloc& __a)
|
---|
541 | : c(__c, __a), comp(__x)
|
---|
542 | { std::make_heap(c.begin(), c.end(), comp); }
|
---|
543 |
|
---|
544 | template<typename _Alloc, typename _Requires = _Uses<_Alloc>>
|
---|
545 | priority_queue(const _Compare& __x, _Sequence&& __c, const _Alloc& __a)
|
---|
546 | : c(std::move(__c), __a), comp(__x)
|
---|
547 | { std::make_heap(c.begin(), c.end(), comp); }
|
---|
548 |
|
---|
549 | template<typename _Alloc, typename _Requires = _Uses<_Alloc>>
|
---|
550 | priority_queue(const priority_queue& __q, const _Alloc& __a)
|
---|
551 | : c(__q.c, __a), comp(__q.comp) { }
|
---|
552 |
|
---|
553 | template<typename _Alloc, typename _Requires = _Uses<_Alloc>>
|
---|
554 | priority_queue(priority_queue&& __q, const _Alloc& __a)
|
---|
555 | : c(std::move(__q.c), __a), comp(std::move(__q.comp)) { }
|
---|
556 | #endif
|
---|
557 |
|
---|
558 | /**
|
---|
559 | * @brief Builds a %queue from a range.
|
---|
560 | * @param __first An input iterator.
|
---|
561 | * @param __last An input iterator.
|
---|
562 | * @param __x A comparison functor describing a strict weak ordering.
|
---|
563 | * @param __s An initial sequence with which to start.
|
---|
564 | *
|
---|
565 | * Begins by copying @a __s, inserting a copy of the elements
|
---|
566 | * from @a [first,last) into the copy of @a __s, then ordering
|
---|
567 | * the copy according to @a __x.
|
---|
568 | *
|
---|
569 | * For more information on function objects, see the
|
---|
570 | * documentation on @link functors functor base
|
---|
571 | * classes@endlink.
|
---|
572 | */
|
---|
573 | #if __cplusplus < 201103L
|
---|
574 | template<typename _InputIterator>
|
---|
575 | priority_queue(_InputIterator __first, _InputIterator __last,
|
---|
576 | const _Compare& __x = _Compare(),
|
---|
577 | const _Sequence& __s = _Sequence())
|
---|
578 | : c(__s), comp(__x)
|
---|
579 | {
|
---|
580 | __glibcxx_requires_valid_range(__first, __last);
|
---|
581 | c.insert(c.end(), __first, __last);
|
---|
582 | std::make_heap(c.begin(), c.end(), comp);
|
---|
583 | }
|
---|
584 | #else
|
---|
585 | template<typename _InputIterator>
|
---|
586 | priority_queue(_InputIterator __first, _InputIterator __last,
|
---|
587 | const _Compare& __x,
|
---|
588 | const _Sequence& __s)
|
---|
589 | : c(__s), comp(__x)
|
---|
590 | {
|
---|
591 | __glibcxx_requires_valid_range(__first, __last);
|
---|
592 | c.insert(c.end(), __first, __last);
|
---|
593 | std::make_heap(c.begin(), c.end(), comp);
|
---|
594 | }
|
---|
595 |
|
---|
596 | template<typename _InputIterator>
|
---|
597 | priority_queue(_InputIterator __first, _InputIterator __last,
|
---|
598 | const _Compare& __x = _Compare(),
|
---|
599 | _Sequence&& __s = _Sequence())
|
---|
600 | : c(std::move(__s)), comp(__x)
|
---|
601 | {
|
---|
602 | __glibcxx_requires_valid_range(__first, __last);
|
---|
603 | c.insert(c.end(), __first, __last);
|
---|
604 | std::make_heap(c.begin(), c.end(), comp);
|
---|
605 | }
|
---|
606 | #endif
|
---|
607 |
|
---|
608 | /**
|
---|
609 | * Returns true if the %queue is empty.
|
---|
610 | */
|
---|
611 | _GLIBCXX_NODISCARD bool
|
---|
612 | empty() const
|
---|
613 | { return c.empty(); }
|
---|
614 |
|
---|
615 | /** Returns the number of elements in the %queue. */
|
---|
616 | size_type
|
---|
617 | size() const
|
---|
618 | { return c.size(); }
|
---|
619 |
|
---|
620 | /**
|
---|
621 | * Returns a read-only (constant) reference to the data at the first
|
---|
622 | * element of the %queue.
|
---|
623 | */
|
---|
624 | const_reference
|
---|
625 | top() const
|
---|
626 | {
|
---|
627 | __glibcxx_requires_nonempty();
|
---|
628 | return c.front();
|
---|
629 | }
|
---|
630 |
|
---|
631 | /**
|
---|
632 | * @brief Add data to the %queue.
|
---|
633 | * @param __x Data to be added.
|
---|
634 | *
|
---|
635 | * This is a typical %queue operation.
|
---|
636 | * The time complexity of the operation depends on the underlying
|
---|
637 | * sequence.
|
---|
638 | */
|
---|
639 | void
|
---|
640 | push(const value_type& __x)
|
---|
641 | {
|
---|
642 | c.push_back(__x);
|
---|
643 | std::push_heap(c.begin(), c.end(), comp);
|
---|
644 | }
|
---|
645 |
|
---|
646 | #if __cplusplus >= 201103L
|
---|
647 | void
|
---|
648 | push(value_type&& __x)
|
---|
649 | {
|
---|
650 | c.push_back(std::move(__x));
|
---|
651 | std::push_heap(c.begin(), c.end(), comp);
|
---|
652 | }
|
---|
653 |
|
---|
654 | template<typename... _Args>
|
---|
655 | void
|
---|
656 | emplace(_Args&&... __args)
|
---|
657 | {
|
---|
658 | c.emplace_back(std::forward<_Args>(__args)...);
|
---|
659 | std::push_heap(c.begin(), c.end(), comp);
|
---|
660 | }
|
---|
661 | #endif
|
---|
662 |
|
---|
663 | /**
|
---|
664 | * @brief Removes first element.
|
---|
665 | *
|
---|
666 | * This is a typical %queue operation. It shrinks the %queue
|
---|
667 | * by one. The time complexity of the operation depends on the
|
---|
668 | * underlying sequence.
|
---|
669 | *
|
---|
670 | * Note that no data is returned, and if the first element's
|
---|
671 | * data is needed, it should be retrieved before pop() is
|
---|
672 | * called.
|
---|
673 | */
|
---|
674 | void
|
---|
675 | pop()
|
---|
676 | {
|
---|
677 | __glibcxx_requires_nonempty();
|
---|
678 | std::pop_heap(c.begin(), c.end(), comp);
|
---|
679 | c.pop_back();
|
---|
680 | }
|
---|
681 |
|
---|
682 | #if __cplusplus >= 201103L
|
---|
683 | void
|
---|
684 | swap(priority_queue& __pq)
|
---|
685 | noexcept(__and_<
|
---|
686 | #if __cplusplus > 201402L || !defined(__STRICT_ANSI__) // c++1z or gnu++11
|
---|
687 | __is_nothrow_swappable<_Sequence>,
|
---|
688 | #else
|
---|
689 | __is_nothrow_swappable<_Tp>,
|
---|
690 | #endif
|
---|
691 | __is_nothrow_swappable<_Compare>
|
---|
692 | >::value)
|
---|
693 | {
|
---|
694 | using std::swap;
|
---|
695 | swap(c, __pq.c);
|
---|
696 | swap(comp, __pq.comp);
|
---|
697 | }
|
---|
698 | #endif // __cplusplus >= 201103L
|
---|
699 | };
|
---|
700 |
|
---|
701 | #if __cpp_deduction_guides >= 201606
|
---|
702 | template<typename _Compare, typename _Container,
|
---|
703 | typename = _RequireNotAllocator<_Compare>,
|
---|
704 | typename = _RequireNotAllocator<_Container>>
|
---|
705 | priority_queue(_Compare, _Container)
|
---|
706 | -> priority_queue<typename _Container::value_type, _Container, _Compare>;
|
---|
707 |
|
---|
708 | template<typename _InputIterator, typename _ValT
|
---|
709 | = typename iterator_traits<_InputIterator>::value_type,
|
---|
710 | typename _Compare = less<_ValT>,
|
---|
711 | typename _Container = vector<_ValT>,
|
---|
712 | typename = _RequireInputIter<_InputIterator>,
|
---|
713 | typename = _RequireNotAllocator<_Compare>,
|
---|
714 | typename = _RequireNotAllocator<_Container>>
|
---|
715 | priority_queue(_InputIterator, _InputIterator, _Compare = _Compare(),
|
---|
716 | _Container = _Container())
|
---|
717 | -> priority_queue<_ValT, _Container, _Compare>;
|
---|
718 |
|
---|
719 | template<typename _Compare, typename _Container, typename _Allocator,
|
---|
720 | typename = _RequireNotAllocator<_Compare>,
|
---|
721 | typename = _RequireNotAllocator<_Container>,
|
---|
722 | typename = _RequireAllocator<_Allocator>>
|
---|
723 | priority_queue(_Compare, _Container, _Allocator)
|
---|
724 | -> priority_queue<typename _Container::value_type, _Container, _Compare>;
|
---|
725 | #endif
|
---|
726 |
|
---|
727 | // No equality/comparison operators are provided for priority_queue.
|
---|
728 |
|
---|
729 | #if __cplusplus >= 201103L
|
---|
730 | template<typename _Tp, typename _Sequence, typename _Compare>
|
---|
731 | inline
|
---|
732 | #if __cplusplus > 201402L || !defined(__STRICT_ANSI__) // c++1z or gnu++11
|
---|
733 | // Constrained free swap overload, see p0185r1
|
---|
734 | typename enable_if<__and_<__is_swappable<_Sequence>,
|
---|
735 | __is_swappable<_Compare>>::value>::type
|
---|
736 | #else
|
---|
737 | void
|
---|
738 | #endif
|
---|
739 | swap(priority_queue<_Tp, _Sequence, _Compare>& __x,
|
---|
740 | priority_queue<_Tp, _Sequence, _Compare>& __y)
|
---|
741 | noexcept(noexcept(__x.swap(__y)))
|
---|
742 | { __x.swap(__y); }
|
---|
743 |
|
---|
744 | template<typename _Tp, typename _Sequence, typename _Compare,
|
---|
745 | typename _Alloc>
|
---|
746 | struct uses_allocator<priority_queue<_Tp, _Sequence, _Compare>, _Alloc>
|
---|
747 | : public uses_allocator<_Sequence, _Alloc>::type { };
|
---|
748 | #endif // __cplusplus >= 201103L
|
---|
749 |
|
---|
750 | _GLIBCXX_END_NAMESPACE_VERSION
|
---|
751 | } // namespace
|
---|
752 |
|
---|
753 | #endif /* _STL_QUEUE_H */
|
---|