list::erase

Remove um elemento ou um intervalo de elementos em uma lista das posições especificadas.

iterator erase(
   iterator _Where
);
iterator erase(
   iterator _First,
   iterator _Last
);

Parâmetros

  • _Where
    Posição do elemento ser removido da lista.

  • _First
    A posição do primeiro elemento removeu da lista.

  • _Last
    Posicione apenas além do último elemento removido da lista.

Valor de retorno

Um iterador bidirecional que designa o primeiro elemento que permanece além de todos os elementos, removidos ou um ponteiro ao final da lista se nenhum tal elemento existe.

Comentários

Nenhuma realocação ocorre, o que iteradores e tornam-se as referências inválidas somente para os elementos apagada.

erase nunca gera uma exceção.

Exemplo

// list_erase.cpp
// compile with: /EHsc
#include <list>
#include <iostream>

int main( ) 
{
   using namespace std;
   list <int> c1;
   list <int>::iterator Iter;
   
   c1.push_back( 10 );
   c1.push_back( 20 );
   c1.push_back( 30 );
   c1.push_back( 40 );
   c1.push_back( 50 );
   cout << "The initial list is:";
   for ( Iter = c1.begin( ); Iter != c1.end( ); Iter++ )
      cout << " " << *Iter;
   cout << endl;

   c1.erase( c1.begin( ) );
   cout << "After erasing the first element, the list becomes:";
   for ( Iter = c1.begin( ); Iter != c1.end( ); Iter++ )
      cout << " " << *Iter;
   cout << endl;
   Iter = c1.begin( );
   Iter++;
   c1.erase( Iter, c1.end( ) );
   cout << "After erasing all elements but the first, the list becomes: ";
   for (Iter = c1.begin( ); Iter != c1.end( ); Iter++ )
      cout << " " << *Iter;
   cout << endl;
}
  

Requisitos

Cabeçalho: <list>

namespace: STD

Consulte também

Referência

list Class

Standard Template Library