unordered_multiset::erase

Статья
02/20/2013

Удаляет элементы в указанных положениях.

iterator erase(iterator where);
iterator erase(iterator first, iterator last);
size_type erase(const Key& keyval);

Параметры

first
Начало диапазона для удаления.
key
Значение ключа для удаления.
last
Элемент диапазона для удаления.
where
Элемент для удаления

Заметки

Функция-член удаляет первый элемент управляемой последовательности, положение которой следуют where.Второй функцию-член удаляет элементы в диапазоне [first, last).Оба получение итератор, задающий первый элемент оставшиеся за всеми удаленными элементами или unordered_multiset::end() если такой элемент не существует.

Третий элемент удаляет элементы, находящиеся в диапазоне by unordered_multiset::equal_range(keyval).Возвращает количество элементов, он удаляется.

Функции-члены никогда не вызывают исключение.

Пример

// std_tr1__unordered_set__unordered_multiset_erase.cpp 
// compile with: /EHsc 
#include <unordered_set> 
#include <iostream> 
 
typedef std::unordered_multiset<char> Myset; 
int main() 
    { 
    Myset c1; 
 
    c1.insert('a'); 
    c1.insert('b'); 
    c1.insert('c'); 
 
// display contents " [c] [b] [a]" 
    for (Myset::const_iterator it = c1.begin(); 
        it != c1.end(); ++it) 
        std::cout << " [" << *it << "]"; 
    std::cout << std::endl; 
 
// erase an element and reinspect 
    Myset::iterator it2 = c1.erase(c1.begin()); 
    std::cout << "*erase(begin()) == [" << *it2 << "]"; 
    std::cout << std::endl; 
 
// add elements and display " [e] [d] [b] [a]" 
    c1.insert('d'); 
    c1.insert('e'); 
 
    for (Myset::const_iterator it = c1.begin(); 
        it != c1.end(); ++it) 
        std::cout << " [" << *it << "]"; 
    std::cout << std::endl; 
 
// erase all but end; 
    it2 = c1.end(); 
    it2 = c1.erase(c1.begin(), --it2); 
    std::cout << "*erase(begin(), end()-1) == [" 
        << *it2 << "]" << std::endl; 
    std::cout << "size() == " << c1.size() << std::endl; 
 
    return (0); 
    }