Biblioteca de algoritmos C ++ - função find_first_of ()

Descrição

A função C ++ std::algorithm::find_first_of()retorna um iterador para o primeiro elemento no intervalo de (primeiro1, último1) que corresponde a qualquer um dos elementos em primeiro2 , último2 . Se nenhum elemento for encontrado, a função retorna last1 .

Declaração

A seguir está a declaração para o cabeçalho da função std :: algorithm :: find_first_of () std :: algorithm.

C ++ 98

template <class ForwardIterator1, class ForwardIterator2>
ForwardIterator1 find_first_of(ForwardIterator1 first1, ForwardIterator1 last1,
   ForwardIterator2 first2, ForwardIterator2 last2);

C ++ 11

template <class InputIterator, class ForwardIterator>
ForwardIterator1 find_first_of(InputIterator first1, InputIterator last1,
   ForwardIterator first2, ForwardIterator last2);

Parâmetros

first1 - Encaminhe o iterador para a posição inicial da primeira sequência.
last1 - Encaminhe o iterador para a posição final da primeira sequência.
first2 - Avance o iterador para a posição inicial da segunda sequência.
last2 - Encaminhe o iterador para a posição final da segunda sequência.

Valor de retorno

Retorna um iterador para o primeiro elemento no intervalo de (primeiro1, último1) que corresponde a qualquer um dos elementos em primeiro2 , último2 . Se nenhum elemento for encontrado, a função retorna last1 .

Exceções

Lança exceção se a comparação de elemento ou uma operação em um iterador lança exceção.

Observe que os parâmetros inválidos causam um comportamento indefinido.

Complexidade de tempo

Linear.

Exemplo

O exemplo a seguir mostra o uso da função std :: algorithm :: find_first_of ().

#include <iostream>
#include <vector>
#include <algorithm>

using namespace std;

int main(void) {
   vector<int> v1 = {5, 2, 6, 1, 3, 4, 7};
   vector<int> v2 = {10, 1};
 
   auto result = find_first_of(v1.begin(), v1.end(), v2.begin(), v2.end());

   if (result != v1.end())
      cout << "Found first match at location " 
         << distance(v1.begin(), result) << endl;

   v2 = {11, 13};

   result = find_end(v1.begin(), v1.end(), v2.begin(), v2.end());

   if (result == v1.end())
      cout << "Sequence doesn't found." << endl;

   return 0;
}

Vamos compilar e executar o programa acima, isso produzirá o seguinte resultado -

Found first match at location 3
Sequence doesn't found.

↰ Previous page