set::upper_bound (STL/CLR)

Artículo
06/07/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 set::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_set_upper_bound.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(); 
 
    System::Console::WriteLine("upper_bound(L'x')==end() = {0}", 
        c1.upper_bound(L'x') == c1.end()); 
 
    System::Console::WriteLine("*upper_bound(L'a') = {0}", 
        *c1.upper_bound(L'a')); 
    System::Console::WriteLine("*upper_bound(L'b') = {0}", 
        *c1.upper_bound(L'b')); 
    return (0); 
    }