Compartir a través de


hash_multiset::lower_bound

NotaNota

Esta API está obsoleta.La alternativa es unordered_multiset (Clase).

Devuelve un iterador al primer elemento de un hash_multiset con una clave a la que sea igual o mayor que una clave especificada.

const_iterator lower_bound( 
   const Key& _Key 
) const; 
iterator lower_bound( 
   const Key& _Key 
);

Parámetros

  • _Key
    La clave de argumento que se va a comparar con el criterio de ordenación de un elemento de hash_multiset que se busca.

Valor devuelto

iterador o const_iterator que dirige la ubicación del primer elemento de un hash_multiset con una clave a la que sea igual o mayor que el argumento, o a la que ejecute la ubicación que funciona correctamente el último elemento del hash_multiset si no se encuentra ninguna coincidencia para la clave.

Comentarios

En Visual C++ .NET 2003, los miembros de los archivos de encabezado <hash_map> y <hash_set> ya no están en el espacio de nombres std, sino que se han movido al espacio de nombres stdext. Vea El espacio de nombres stdext para obtener más información.

Ejemplo

// hash_multiset_lower_bound.cpp
// compile with: /EHsc
#include <hash_set>
#include <iostream>

int main() {
   using namespace std;
   using namespace stdext;
   hash_multiset <int> hms1;
   hash_multiset <int> :: const_iterator hms1_AcIter, hms1_RcIter;
   
   hms1.insert( 10 );
   hms1.insert( 20 );
   hms1.insert( 30 );

   hms1_RcIter = hms1.lower_bound( 20 );
   cout << "The element of hash_multiset hms1 with a key of 20 is: "
        << *hms1_RcIter << "." << endl;

   hms1_RcIter = hms1.lower_bound( 40 );

   // If no match is found for the key, end( ) is returned
   if ( hms1_RcIter == hms1.end( ) )
      cout << "The hash_multiset hms1 doesn't have an element "
           << "with a key of 40." << endl;
   else
      cout << "The element of hash_multiset hms1 with a key of 40 is: "
           << *hms1_RcIter << "." << endl;

   // An element at a specific location in the hash_multiset can be found 
   // by using a dereferenced iterator that addresses the location
   hms1_AcIter = hms1.end( );
   hms1_AcIter--;
   hms1_RcIter = hms1.lower_bound( *hms1_AcIter );
   cout << "The element of hms1 with a key matching "
        << "that of the last element is: "
        << *hms1_RcIter << "." << endl;
}

Resultados

The element of hash_multiset hms1 with a key of 20 is: 20.
The hash_multiset hms1 doesn't have an element with a key of 40.
The element of hms1 with a key matching that of the last element is: 30.

Requisitos

Encabezado: <hash_set>

Espacio de nombres: stdext

Vea también

Referencia

hash_multiset (Clase)

Biblioteca de plantillas estándar