Partilhar via


set::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 set::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_set_erase.cpp 
// compile with: /clr 
#include <cliext/set> 
 
typedef cliext::set<wchar_t> Myset; 
int main() 
    { 
    Myset 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 
    Myset::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:

Consulte também

Referência

set (STL/CLR)

set::clear (STL/CLR)