Namespaces
Variants

std::pop_heap

De fr.cppreference.net
 
 
Bibliothèque d'algorithmes
Algorithmes contraints et algorithmes sur les plages (C++20)
Algorithmes contraints, p. ex. ranges::copy, ranges::sort, ...
Opérations de séquence non modificatrices    
Opérations par lots
(C++17)
Opérations de recherche
Opérations de séquence modificatrices
Opérations de copie
(C++11)
(C++11)
Opérations d'échange
Opérations de transformation
Opérations de génération
Opérations de suppression
Opérations de changement d'ordre
(jusqu'à C++17)(C++11)
(C++20)(C++20)
Opérations d'échantillonnage
(C++17)

Tri et opérations connexes
Opérations de partitionnement
(C++11)    

Opérations de tri
Opérations de recherche binaire
(sur des plages partitionnées)
Opérations d'ensemble (sur des plages triées)
Opérations de fusion (sur des plages triées)
Opérations de tas
Opérations de minimum/maximum
(C++11)
(C++17)
Opérations de comparaison lexicographique
Opérations de permutation


 
Défini dans l'en-tête <algorithm>
template< class RandomIt >
void pop_heap( RandomIt first, RandomIt last );
(1) (constexpr depuis C++20)
template< class RandomIt, class Compare >
void pop_heap( RandomIt first, RandomIt last, Compare comp );
(2) (constexpr depuis C++20)

Échange la valeur à la position first et la valeur à la position last - 1 et transforme la sous-plage [firstlast - 1) en un tas. Cela a pour effet de supprimer le premier élément du tas [firstlast).

1) [firstlast) est un tas par rapport à operator<(jusqu'à C++20)std::less{}(depuis C++20).
2) [firstlast) est un tas par rapport à comp.

Si l'une des conditions suivantes est satisfaite, le comportement est indéfini :

  • [firstlast) est vide.
  • [firstlast) n'est pas un tas par rapport au comparateur correspondant.
(jusqu'à C++11)
(depuis C++11)

Paramètres

first, last - la paire d'itérateurs définissant la plage de tas binaire non vide des éléments à modifier (extraire l'élément racine) la paire d'itérateurs définissant la plage de tas binaire non vide des éléments à modifier (extraire l'élément racine)plage des éléments à modifier (extraire l'élément racine)
comp - objet fonction de comparaison (c'est-à-dire un objet qui satisfait aux exigences de Compare) qui renvoie truetrue si le premier argument est inférieur au second.

La signature de la fonction de comparaison doit être équivalente à la suivante :

bool cmp(const Type1& a, const Type2& b);

Bien que la signature n'ait pas besoin d'avoir const&, la fonction ne doit pas modifier les objets qui lui sont passés et doit pouvoir accepter toutes les valeurs de type (possiblement const) Type1 et Type2 indépendamment de la catégorie de valeur (ainsi, Type1& n'est pas autorisé, pas plus que Type1 sauf si pour Type1 un déplacement équivaut à une copie(depuis C++11)).
Les types Type1 et Type2 doivent être tels qu'un objet de type RandomIt puisse être déréférencé puis implicitement converti vers les deux.

Exigences de type
-
RandomIt doit satisfaire aux exigences de LegacyRandomAccessIterator.
-
Compare doit satisfaire aux exigences de Compare.

Complexité

Étant donné N comme std::distance(first, last):

1) Au plus 2log(N) comparaisons utilisant operator<(jusqu'à C++20)std::less{}(depuis C++20).
2) Au plus 2log(N) applications de la fonction de comparaison comp.

Exemple

#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);
}

Sortie :

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

Rapports de défauts

Les rapports de défauts suivants, modifiant le comportement, ont été appliqués rétroactivement aux normes C++ publiées précédemment.

DR Appliqué à Comportement publié Comportement corrigé
LWG 1205 C++98 le comportement n'était pas clair si [firstlast) est vide le comportement est indéfini dans ce cas

Voir aussi

ajoute un élément à un tas max
(modèle de fonction & objet fonction d'algorithme)
(C++11)
vérifie si la plage donnée est un tas max
(modèle de fonction & objet fonction d'algorithme)
trouve la plus grande sous-plage qui est un tas max
(modèle de fonction & objet fonction d'algorithme)
crée un tas max à partir d'une plage d'éléments
(modèle de fonction & objet fonction d'algorithme)
transforme un tas max en une plage d'éléments triés par ordre croissant
(modèle de fonction & objet fonction d'algorithme)
supprime le plus grand élément d'un tas max
(algorithme objet fonction)