hash_map::erase

Notes

Cette API est obsolète.L'alternative est unordered_map, classe.

Supprime un élément ou une plage des éléments dans un hash_map les positions spécifiées ou supprimer les éléments qui correspondent à la clé spécifiée.

iterator erase( 
   iterator _Where 
); 
iterator erase( 
   iterator _First, 
   iterator _Last 
); 
size_type erase( 
   const key_type& _Key 
);

Paramètres

• _Where
  Position de l'élément à supprimer du hash_map.

• _First
  Position du premier élément est supprimé du hash_map.

• _Last
  Placez simplement au delà de le dernier élément supprimé du hash_map.

• _Key
  La valeur de clé des éléments à supprimer du hash_map.

Valeur de retour

Pour les deux premières fonctions de membre, un itérateur bidirectionnelle qui indique le premier élément restant au delà de tous les éléments supprimés, ou un pointeur à la fin de le hash_map si aucun ce élément n'existe.

Pour la troisième fonction membre, retourne le nombre d'éléments supprimés du hash_map.

Notes

Les fonctions membres ne jamais lèvent une exception.

Dans Visual C++ .NET 2003, les membres des fichiers d'en-tête <hash_map> et de <hash_set> ne sont plus dans l'espace de noms standard, mais ont été plutôt déplacés dans l'espace de noms de stdext. Pour plus d'informations, consultez The stdext Namespace.

Exemple

Lors de la compilation de cet exemple avec l'indicateur d'/Wp64 ou sur une plateforme 64 bits, l'avertissement du compilateur C4267 est généré. Pour plus d'informations sur cet avertissement, consultez Avertissement du compilateur (niveau 3) C4267.

// hash_map_erase.cpp
// compile with: /EHsc
#include <hash_map>
#include <iostream>

int main()
{
    using namespace std;
    using namespace stdext;
    hash_map<int, int> hm1, hm2, hm3;
    hash_map<int, int> :: iterator pIter, Iter1, Iter2;
    int i;
    hash_map<int, int>::size_type n;
    typedef pair<int, int> Int_Pair;

    for (i = 1; i < 5; i++)
    {
        hm1.insert(Int_Pair (i, i));
        hm2.insert(Int_Pair (i, i*i));
        hm3.insert(Int_Pair (i, i-1));
    }

    // The 1st member function removes an element at a given position
    Iter1 = ++hm1.begin();
    hm1.erase(Iter1);

    cout << "After the 2nd element is deleted, the hash_map hm1 is:";
    for (pIter = hm1.begin(); pIter != hm1.end(); pIter++)
        cout << " " << pIter -> second;
    cout << "." << endl;

    // The 2nd member function removes elements
    // in the range [_First, _Last)
    Iter1 = ++hm2.begin();
    Iter2 = --hm2.end();
    hm2.erase(Iter1, Iter2);

    cout << "After the middle two elements are deleted, "
         << "the hash_map hm2 is:";
    for (pIter = hm2.begin(); pIter != hm2.end(); pIter++)
        cout << " " << pIter -> second;
    cout << "." << endl;

    // The 3rd member function removes elements with a given _Key
    n = hm3.erase(2);

    cout << "After the element with a key of 2 is deleted,\n"
         << "the hash_map hm3 is:";
    for (pIter = hm3.begin(); pIter != hm3.end(); pIter++)
        cout << " " << pIter -> second;
    cout << "." << endl;

    // The 3rd member function returns the number of elements removed
    cout << "The number of elements removed from hm3 is: "
         << n << "." << endl;

    // The dereferenced iterator can also be used to specify a key
    Iter1 = ++hm3.begin();
    hm3.erase(Iter1);

    cout << "After another element with a key equal to that"
         << endl;
    cout  << "of the 2nd element is deleted, "
          << "the hash_map hm3 is:";
    for (pIter = hm3.begin(); pIter != hm3.end(); pIter++)
        cout << " " << pIter -> second;
    cout << "." << endl;
}

Configuration requise

En-tête: <hash_map>

Espace de noms : stdext

Voir aussi

Référence

hash_map, classe

Bibliothèque STL (Standard Template Library)