Compartilhar via


find_if

Localiza a posição da primeira ocorrência de um elemento em um intervalo que satisfaz uma condição especificada.

template<class InputIterator, class Predicate>
   InputIterator find_if(
      InputIterator _First, 
      InputIterator _Last, 
      Predicate _Pred
   );

Parâmetros

  • _First
    Um iterador de entrada que trata a posição do primeiro elemento no intervalo ser pesquisada.

  • _Last
    Um iterador de entrada que trata a posição uma após o elemento final no intervalo ser pesquisada.

  • _Pred
    Objeto definido pelo usuário da função de predicado que define a condição seja satisfeita pelo elemento que está sendo procurado para.Um predicado leva o único argumento e retorna true ou false.

Valor de retorno

Um iterador de entrada que endereçe o primeiro elemento no intervalo que satisfaz a condição especificado por predicado.

Comentários

Esta função do modelo é uma generalização do algoritmo localizar, substituindo o predicado “equals um determinado valor” com qualquer predicado.

Exemplo

// alg_find_if.cpp
// compile with: /EHsc
#include <list>
#include <algorithm>
#include <iostream>

bool greater10 ( int value )
{
   return value >10;
}

int main( )
{
   using namespace std;

   list <int> L;
   list <int>::iterator Iter;
   list <int>::iterator result;
   
   L.push_back( 5 );
   L.push_back( 10 );
   L.push_back( 15 );
   L.push_back( 20 );
   L.push_back( 10 );

   cout << "L = ( " ;
   for ( Iter = L.begin( ) ; Iter != L.end( ) ; Iter++ )
      cout << *Iter << " ";
   cout << ")" << endl;

   
   result = find_if( L.begin( ), L.end( ), &greater10 );
   if ( result == L.end( ) )
      cout << "There is no element greater than 10 in list L."
           << endl;
   else
   {
      result++;
      cout << "There is an element greater than 10 in list L,"
           << "\n and it is followed by a "
           <<  *(result) << "." << endl;
   }
}
  

Requisitos

Cabeçalho: <algorithm>

namespace: STD

Consulte também

Referência

find_if (STL Samples)

Standard Template Library