List::Erase (STL/CLR)
Remove os elementos em posições especificadas.
iterator erase(iterator where);
iterator erase(iterator first, iterator last);
Parâmetros
primeira
Início do intervalo para apagar.última
Final do intervalo para apagar.onde
Elemento para apagar.
Comentários
A primeira função de membro remove o elemento da seqüência controlada apontado pelo where.Você pode usá-lo para remover um único elemento.
A segunda função de membro remove os elementos da seqüência controlada no intervalo [first, last).Você pode usá-lo para remover zero ou mais elementos contíguos.
Ambas as funções de membro retornam um iterador que designa o primeiro elemento restante além quaisquer elementos removidos, ou List::end (STL/CLR)() se nenhum elemento tal existir.
Ao apagar elementos, o número de cópias do elemento é linear no número de elementos entre o fim de apagamento e qual final da seqüência.(Ao apagar um ou mais elementos no final de seqüência, nenhum elemento cópias ocorrerem.)
Exemplo
// cliext_list_erase.cpp
// compile with: /clr
#include <cliext/list>
int main()
{
cliext::list<wchar_t> c1;
c1.push_back(L'a');
c1.push_back(L'b');
c1.push_back(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.push_back(L'd');
c1.push_back(L'e');
for each (wchar_t elem in c1)
System::Console::Write(" {0}", elem);
System::Console::WriteLine();
// erase all but end
cliext::list<wchar_t>::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
Cabeçalho: < cliext/lista >
Namespace: cliext