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 :: algorithm :: adjac_find ().

C ++ 98

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

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.

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 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;

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

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

   v[3] = 4;

   it = adjacent_find(v.begin(), v.end());

   if (it == v.end())
      cout << "There are no cosecutive identical elemens" << endl;

   return 0;
}

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

First occurrence of consecutive identical element = 3
There are no cosecutive identical elemens