hash_multimap::upper_bound (STL/CLR)

Artículo
02/19/2013

Encuentra el final del intervalo que coincide con una clave especificada.

    iterator upper_bound(key_type key);

Parámetros

clave
Valor de clave que se va a buscar.

Comentarios

La función miembro determina el último elemento X en la secuencia controlada que aplica un algoritmo hash al mismo depósito que key y tiene equivalente de ordenación a key.Si no existe ningún elemento, o si X es el último elemento de la secuencia controlada, devuelve hash_multimap::end (STL/CLR)(); si no devuelve un iterador que señala el primer elemento más allá de X.Se utiliza para buscar el final de una secuencia de elementos actualmente en la secuencia controlada que coinciden con una clave especificada.

Ejemplo

// cliext_hash_multimap_upper_bound.cpp 
// compile with: /clr 
#include <cliext/hash_map> 
 
typedef cliext::hash_multimap<wchar_t, int> Myhash_multimap; 
int main() 
    { 
    Myhash_multimap c1; 
    c1.insert(Myhash_multimap::make_value(L'a', 1)); 
    c1.insert(Myhash_multimap::make_value(L'b', 2)); 
    c1.insert(Myhash_multimap::make_value(L'c', 3)); 
 
// display contents " [a 1] [b 2] [c 3]" 
    for each (Myhash_multimap::value_type elem in c1) 
        System::Console::Write(" [{0} {1}]", elem->first, elem->second); 
    System::Console::WriteLine(); 
 
    System::Console::WriteLine("upper_bound(L'x')==end() = {0}", 
        c1.upper_bound(L'x') == c1.end()); 
 
    Myhash_multimap::iterator it = c1.upper_bound(L'a'); 
    System::Console::WriteLine("*upper_bound(L'a') = [{0} {1}]", 
        it->first, it->second); 
    it = c1.upper_bound(L'b'); 
    System::Console::WriteLine("*upper_bound(L'b') = [{0} {1}]", 
        it->first, it->second); 
    return (0); 
    }