upper_bound

Sintaxis:

    #include <set>
    iterator upper_bound( const key_type& valor );
    const_iterator upper_bound( const key_type& valor ) const;

La función miembro upper_bound retorna un iterador cota al primer elemento que tiene un valor "mayor" (acorde a las semánticas escogidas) que la llave valor en el objeto conjunto.

upper_bound es una especialización del :es:algorithm: upper_bound para operar de manera eficiente con conjuntos, y es equivalente a la invocación upper_bound ( conjunto.begin(), conjunto.end(), valor, conjunto.compare() );.

Esta función miembro se ejecuta en tiempo logarítmico.

Parámetros

• valor: el valor o llave para el cual se desea buscar una cota.

Retorno

Un iterador apuntando a una ubicación específica en el conjunto que cumple lo siguiente:

set<type> conjunto;
set<type>::iterator cota = conjunto.upper_bound(valor);
'' lo siguiente es verdadero
false == conjunto.compare()(cota, valor);

Ver También

• Especialización del algoritmo upper_bound.
• lower_bound