std::pop_heap
| Definiert in Header <algorithm>
|
||
template< class RandomIt >
void pop_heap( RandomIt first, RandomIt last );
|
(1) | (constexpr seit C++20) |
template< class RandomIt, class Compare >
void pop_heap( RandomIt first, RandomIt last, Compare comp );
|
(2) | (constexpr seit C++20) |
Vertauscht den Wert an Position first mit dem Wert an Position last - 1 und macht den Teilbereich [first, last - 1) zu einem Heap. Dies hat die Wirkung, das erste Element aus dem Heap [first, last) zu entfernen.
[first, last) ist ein Heap bezüglich operator<(bis C++20)std::less{}(seit C++20).[first, last) ist ein Heap bezüglich comp.Wenn eine der folgenden Bedingungen erfüllt ist, ist das Verhalten undefiniert:
[first,last)ist leer.[first,last)ist kein Heap bezüglich des entsprechenden Komparators.
|
(bis C++11) |
|
(seit C++11) |
Parameter
| first, last | - | das Iteratorpaar, das den nicht-leeren binären Heap Bereich von zu modifizierenden Elementen definiert (Wurzelelement extrahieren) |
| comp | - | Vergleichsfunktionsobjekt (d.h. ein Objekt, das die Anforderungen von Compare erfüllt), das true zurückgibt, wenn das erste Argument kleiner als das zweite ist.Die Signatur der Vergleichsfunktion sollte der folgenden entsprechen:
Während die Signatur kein |
| Typanforderungen | ||
-RandomIt muss die Anforderungen von LegacyRandomAccessIterator erfüllen.
| ||
-Compare muss die Anforderungen von Compare erfüllen.
| ||
Komplexität
Gegeben N als std::distance(first, last):
operator<(bis C++20)std::less{}(seit C++20).comp.Beispiel
#include <algorithm>
#include <iostream>
#include <string_view>
#include <type_traits>
#include <vector>
void println(std::string_view rem, const auto& v)
{
std::cout << rem;
if constexpr (std::is_scalar_v<std::decay_t<decltype(v)>>)
std::cout << v;
else
for (int e : v)
std::cout << e << ' ';
std::cout << '\n';
}
int main()
{
std::vector<int> v{3, 1, 4, 1, 5, 9};
std::make_heap(v.begin(), v.end());
println("after make_heap: ", v);
std::pop_heap(v.begin(), v.end()); // moves the largest to the end
println("after pop_heap: ", v);
int largest = v.back();
println("largest element: ", largest);
v.pop_back(); // actually removes the largest element
println("after pop_back: ", v);
}
Ausgabe:
after make_heap: 9 5 4 1 1 3
after pop_heap: 5 3 4 1 1 9
largest element: 9
after pop_back: 5 3 4 1 1
Fehlerberichte
Die folgenden verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.
| DR | Angewendet auf | Verhalten wie veröffentlicht | Korrektes Verhalten |
|---|---|---|---|
| LWG 1205 | C++98 | das Verhalten war unklar, wenn [first, last) leer ist
|
das Verhalten ist in diesem Fall undefiniert |
Siehe auch
| fügt ein Element zu einem Max-Heap hinzu (Funktionsschablone & Algorithmus-Funktionsobjekt) | |
(C++20) |
|
(C++11) |
prüft, ob der angegebene Bereich ein Max-Heap ist (Funktionsschablone & Algorithmus-Funktionsobjekt) |
(C++20) |
|
(C++11) |
findet den größten Teilbereich, der ein Max-Heap ist (Funktionsschablone & Algorithmus-Funktionsobjekt) |
(C++20) |
|
| erstellt einen Max-Heap aus einem Bereich von Elementen (Funktionsschablone & Algorithmus-Funktionsobjekt) | |
(C++20) |
|
| wandelt einen Max-Heap in einen aufsteigend sortierten Bereich von Elementen um (Funktionsschablone & Algorithmus-Funktionsobjekt) | |
(C++20) |
|
(C++20) |
entfernt das größte Element aus einem Max-Heap (Algorithmus-Funktionsobjekt) |