unordered_multiset::erase
Remove os elementos em posições especificadas.
iterator erase(iterator where);
iterator erase(iterator first, iterator last);
size_type erase(const Key& keyval);
Parâmetros
first
Início do intervalo a ser apagado.key
Valor de chave para apagar.last
Fim do intervalo a ser apagado.where
Elemento para apagar
Comentários
A primeira função de membro remove o elemento da seqüência controlado apontada por where.A segunda função de membro remove os elementos no intervalo [first, last).Os dois retornam um iterador que designa o primeiro elemento restantes além quaisquer elementos removidos, ou unordered_multiset::end() se não há tal elemento existe.
O terceiro membro remove os elementos do intervalo delimitados por unordered_multiset::equal_range(keyval).Ele retorna o número de elementos, que ele remove.
As funções de membro nunca lançam uma exceção.
Exemplo
// 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);
}
Requisitos
Cabeçalho: <unordered_set>
Namespace: std