find

Sintaxis

    #include <algorithm>
    input_iterator find( input_iterator inicio, input_iterator fin, const T& val );

• inicio y fin modelan Input Iterator.

La función find() devuelve un iterador apuntando al lugar en el rango donde primero se ha encontrado el valor val.

• • Retorno**: un input_iterator x tal que *x==val si val se encuentra en el rango; o el iterador fin si no se encuentra.

Ejemplo

El código siguiente utiliza find() para encontrar el valor target_value (por ejemplo, 3) en un vector:

   vector<int> v;
   for( int i = 0; i < 10; i++ ) {
     v.push_back( i );
   }
 
   int target_value = 3;
   vector<int>::iterator pos_item = find( v.begin(), v.end(), target_value );
 
   cout << "v "<< 
   (pos_item != v.end() ? "contains" : "does not contain")<< 
   " the value "<< target_value<< endl;

La salida de este código es como la siguiente:

   v contains the value 3

Detalles

Si el rango [inicio..fin) se mantiene inmutable entre una llamada a count() y una llamada a find(), se cumple que:

( 0 != count(inicio,fin,val) ) <==> ( fin != find(inicio,fin,val) )

Tópicos Relacionados

• find_if -- encuentra un valor en un rango que cumpla una condición
• find_first_of -- encuentra uno de varios posibles valores
• count, count_if -- cuenta ocurrencias de un valor
• accumulate, adjacent_difference inner_product