set::erase

Článek
03/26/2013

Odebere prvek nebo rozsah prvků v sadě od zadané pozice nebo odebere prvky, které odpovídají zadaným klíčem.

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

Parametry

_Where
Umístění prvku bude odebrán ze sady.
_First
Pozice prvního prvku odebrán ze sady.
_Last
Za poslední prvek pozice odebrán ze sady.
_Key
Klíč bude odebrán ze sady prvků.

Vrácená hodnota

Pro první dva členské funkce obousměrný iterace, označí první prvek zbývající za jakékoliv prvky odstraněny nebo ukazatel na konec sady, pokud neexistuje žádný takový prvek.Třetí funkce člena, počet prvků, které byly odebrány ze sady.

[!POZNÁMKA]

Tento návratový typ nevyhovuje standardu jazyka C++.

Poznámky

V některých případech tato metoda může být vyvolána out_of_range výjimku.

Příklad

Při kompilování v tomto příkladu se /Wp64 příznak nebo na 64bitové platformě budou generovány kompilátoru upozornění C4267.Další informace o tomto upozornění naleznete v C4267 (úroveň 3) upozornění kompilátoru.

// set_erase.cpp
// compile with: /EHsc
#include <set>
#include <iostream>

int main()
{
    using namespace std;
    set<int> s1, s2, s3;
    set<int>::iterator pIter, Iter1, Iter2;
    int i;
    set<int>::size_type n;

    for (i = 1; i < 5; i++)
    {
        s1.insert(i);
        s2.insert(i * i);
        s3.insert(i - 1);
    }

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

    cout << "After the 2nd element is deleted, the set s1 is:";
    for (pIter = s1.begin(); pIter != s1.end(); pIter++)
        cout << " " << *pIter;
    cout << "." << endl;

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

    cout << "After the middle two elements are deleted, "
         << "the set s2 is:";
    for (pIter = s2.begin(); pIter != s2.end(); pIter++)
        cout << " " << *pIter;
    cout << "." << endl;

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

    cout << "After the element with a key of 2 is deleted, "
         << "the set s3 is:";
    for (pIter = s3.begin(); pIter != s3.end(); pIter++)
        cout << " " << *pIter;
    cout << "." << endl;

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

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

    cout << "After another element (unique for set) with a key"
         << endl;
    cout << "equal to that of the 2nd element is deleted, "
         << "the set s3 is:";
    for (pIter = s3.begin(); pIter != s3.end(); pIter++)
        cout << " " << *pIter;
    cout << "." << endl;
}

Požadavky

Záhlaví: <set>

Obor názvů: std

Viz také

Referenční dokumentace

set Class

Standardní šablona knihovny

Sdílet prostřednictvím