Compartilhar via


hash_multimap::Erase (STL/CLR)

Remove os elementos em posições especificadas.

    iterator erase(iterator where);
    iterator erase(iterator first, iterator last);
    bool erase(key_type key)

Parâmetros

  • primeira
    Início do intervalo para apagar.

  • key
    Valor de chave 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 wheree retorna um iterador que designa o primeiro elemento restante além do elemento removido, ou hash_multimap::end (STL/CLR)() se nenhum elemento tal existir.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)e retorna um iterador que designa o primeiro elemento restante além quaisquer elementos removidos, ou end() se nenhum elemento tal existir..Você pode usá-lo para remover zero ou mais elementos contíguos.

A terceira função de membro remove qualquer elemento da seqüência controlada cuja chave tem equivalente a ordenação para keye retorna uma contagem do número de elementos removidos.Você pode usá-lo para remover e contar todos os elementos que correspondem a uma chave especificada.

A eliminação de cada elemento leva tempo proporcional ao logaritmo do número de elementos na seqüência controlada.

Exemplo

// cliext_hash_multimap_erase.cpp 
// compile with: /clr 
#include <cliext/hash_map> 
 
typedef cliext::hash_multimap<wchar_t, int> Myhash_multimap; 
int main() 
    { 
    cliext::hash_multimap<wchar_t, int> c1; 
    c1.insert(cliext::hash_multimap<wchar_t, int>::make_value(L'a', 1)); 
    c1.insert(cliext::hash_multimap<wchar_t, int>::make_value(L'b', 2)); 
    c1.insert(cliext::hash_multimap<wchar_t, int>::make_value(L'c', 3)); 
 
// display contents " [a 1] [b 2] [c 3]" 
    for each (cliext::hash_multimap<wchar_t, int>::value_type elem in c1) 
        System::Console::Write(" [{0} {1}]", elem->first, elem->second); 
    System::Console::WriteLine(); 
 
// erase an element and reinspect 
    cliext::hash_multimap<wchar_t, int>::iterator it = 
        c1.erase(c1.begin()); 
    System::Console::WriteLine("erase(begin()) = [{0} {1}]", 
        it->first, it->second); 
 
// add elements and display " b c d e" 
    c1.insert(cliext::hash_multimap<wchar_t, int>::make_value(L'd', 4)); 
    c1.insert(cliext::hash_multimap<wchar_t, int>::make_value(L'e', 5)); 
    for each (cliext::hash_multimap<wchar_t, int>::value_type elem in c1) 
        System::Console::Write(" [{0} {1}]", elem->first, elem->second); 
    System::Console::WriteLine(); 
 
// erase all but end 
    it = c1.end(); 
    it = c1.erase(c1.begin(), --it); 
    System::Console::WriteLine("erase(begin(), end()-1) = [{0} {1}]", 
        it->first, it->second); 
    System::Console::WriteLine("size() = {0}", c1.size()); 
 
// erase end 
    System::Console::WriteLine("erase(L'x') = {0}", c1.erase(L'x')); 
    System::Console::WriteLine("erase(L'e') = {0}", c1.erase(L'e')); 
    return (0); 
    } 
 
  

Requisitos

Cabeçalho: < cliext/hash_map >

Namespace: cliext

Consulte também

Referência

hash_multimap (STL/CLR)

hash_multimap::Clear (STL/CLR)