multiset::erase (STL/CLR)
Remove os elementos nas posições especificadas.
iterator erase(iterator where);
iterator erase(iterator first, iterator last);
size_type erase(key_type key)
Parâmetros
primeiro
Início do intervalo para apagar.key
Valor de chave para apagar.last
O fim do intervalo para apagar.onde
Elemento para apagar.
Comentários
A primeira função de membro remove o elemento de sequência controlada apontada por where, e retorna um iterador que designa o primeiro elemento que permanece além de elemento removido, ou multiset::end (STL/CLR)() se tal elemento existe. Use-a para remover um único elemento.
A segunda função de membro remove os elementos de sequência controlada no intervalo [first, last), e retorna um iterador que designa o primeiro elemento que permanece além de todos os elementos removidos, ou end() se tal elemento existirão. Use-a para remover os elementos zero ou mais contíguas.
A terceira função de membro remove qualquer elemento da sequência controlada cuja chave tem o equivalente de ordenação da key, e retorna uma contagem do número de elementos removidos. Use-a para remover e contar todos os elementos que correspondem a uma chave especificada.
Cada exclusão do elemento usa o tempo proporcionais ao logaritmo o número de elementos na sequência controlada.
Exemplo
// cliext_multiset_erase.cpp
// compile with: /clr
#include <cliext/set>
typedef cliext::multiset<wchar_t> Mymultiset;
int main()
{
Mymultiset c1;
c1.insert(L'a');
c1.insert(L'b');
c1.insert(L'c');
// display initial contents " a b c"
for each (wchar_t elem in c1)
System::Console::Write(" {0}", elem);
System::Console::WriteLine();
// erase an element and reinspect
System::Console::WriteLine("erase(begin()) = {0}",
*c1.erase(c1.begin()));
// add elements and display " b c d e"
c1.insert(L'd');
c1.insert(L'e');
for each (wchar_t elem in c1)
System::Console::Write(" {0}", elem);
System::Console::WriteLine();
// erase all but end
Mymultiset::iterator it = c1.end();
System::Console::WriteLine("erase(begin(), end()-1) = {0}",
*c1.erase(c1.begin(), --it));
System::Console::WriteLine("size() = {0}", c1.size());
return (0);
}
Requisitos
cliext </conjunto deCabeçalho: >
cliext deNamespace: