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