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 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 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_multimap_upper_bound.cpp 
// compile with: /clr 
#include <cliext/map> 
 
typedef cliext::multimap<wchar_t, int> Mymultimap; 
int main() 
    { 
    Mymultimap c1; 
    c1.insert(Mymultimap::make_value(L'a', 1)); 
    c1.insert(Mymultimap::make_value(L'b', 2)); 
    c1.insert(Mymultimap::make_value(L'c', 3)); 
 
// display contents " [a 1] [b 2] [c 3]" 
    for each (Mymultimap::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()); 
 
    Mymultimap::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); 
    }