Compartilhar via


Vector::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 Vector::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_vector_erase.cpp 
// compile with: /clr 
#include <cliext/vector> 
 
int main() 
    { 
    cliext::vector<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::vector<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/vetor >

Namespace: cliext

Consulte também

Referência

vetor (STL/CLR)

Vector::Clear (STL/CLR)