Biblioteca de Algoritmo C ++ - função adjacente_find ()

Descrição

A função C ++ std::algorithm::adjacent_find() encontra a primeira ocorrência de dois elementos consecutivos que são idênticos e retorna um iterador apontando para o primeiro elemento se um elemento idêntico existir consecutivamente, caso contrário, retorna um iterador apontando para o último elemento.

Declaração

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

template <class ForwardIterator, class BinaryPredicate>
ForwardIterator adjacent_find(ForwardIterator first, ForwardIterator last, BinaryPredicate pred);

Parâmetros

  • first - Encaminha iteradores para as posições iniciais da sequência pesquisada.

  • last - Encaminha os iteradores para as posições finais da sequência pesquisada.

  • pred- Esta é uma função que recebe dois argumentos e retorna bool .

Valor de retorno

Retorna um iterador apontando para o primeiro elemento se um elemento idêntico existir consecutivamente, caso contrário, retorna um iterador apontando para o último elemento.

Exceções

A exceção é lançada se qualquer objeto de comparação de elemento lançar uma exceção.

Observe que os argumentos inválidos causam um comportamento indefinido.

Complexidade de tempo

Linear na distância entre o primeiro e o último .

Exemplo

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

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

using namespace std;

bool predicate(int a, int b) {
   return (a == b);
}

int main(void) {
   vector<int> v = {1, 2, 3, 3, 4, 5, 5};
   auto it = adjacent_find(v.begin(), v.end());

   if (it != v.end())
      cout << "First occurrence of consecutive identical element = "
         << *it << endl;

   it = adjacent_find(++it, v.end(), predicate);

   if (it != v.end())
      cout << "Second occurrence of consecutive identical element = "
         << *it << endl;

   return 0;
}

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

First occurrence of consecutive identical element = 3
Second occurrence of consecutive identical element = 5