Compartir a través de


set::find

Devuelve un iterador que dirige la ubicación de un elemento en un conjunto que tenga un equivalente key en una clave especificada.

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

Parámetros

  • _Key
    La clave de argumento que se coincidirá con el criterio de ordenación de un elemento de conjunto que se busca.

Valor devuelto

Un iterador o const_iterator que dirige la ubicación de un equivalente de elemento a una clave especificada o que dirige la ubicación que funciona correctamente el último elemento del conjunto si no se encuentra ninguna coincidencia para la clave.

Comentarios

La función miembro devuelve un iterador que dirige un elemento del conjunto cuyo criterio de ordenación es equivalente a la clave del argumento en predicado binario que induzca orden basado en que la relación de la comparabilidad.

Si el valor devuelto de búsqueda se asigna a const_iterator, el objeto determinado no puede modificarse.Si el valor devuelto de búsqueda se asigna a iterador, el objeto determinado puede modificarse.

Ejemplo

// set_find.cpp
// compile with: /EHsc
#include <set>
#include <iostream>

int main( )
{
   using namespace std;
   set <int> s1;
   set <int> :: const_iterator s1_AcIter, s1_RcIter;
   
   s1.insert( 10 );
   s1.insert( 20 );
   s1.insert( 30 );

   s1_RcIter = s1.find( 20 );
   cout << "The element of set s1 with a key of 20 is: "
        << *s1_RcIter << "." << endl;

   s1_RcIter = s1.find( 40 );

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

   // The element at a specific location in the set can be found 
   // by using a dereferenced iterator addressing the location
   s1_AcIter = s1.end( );
   s1_AcIter--;
   s1_RcIter = s1.find( *s1_AcIter );
   cout << "The element of s1 with a key matching "
        << "that of the last element is: "
        << *s1_RcIter << "." << endl;
}
  
  
  

Requisitos

encabezado: <conjunto>

espacio de nombres: std

Vea también

Referencia

set Class

set::find (STL Samples)

Biblioteca de plantillas estándar