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

Descrição

A função C ++ std::algorithm::equal()testa se dois conjuntos de elementos são iguais ou não. O tamanho de ambos os conjuntos não precisa ser igual. Ele usa o operador == para comparação.

Declaração

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

C ++ 98

template <class InputIterator1, class InputIterator2>
bool equal(InputIterator1 first1, InputIterator1 last1, InputIterator2 first2);

Parâmetros

  • first1 - Insira o iterador na posição inicial da primeira sequência.

  • last1 - Insira o iterador na posição final da primeira sequência.

  • first2 - Insira o iterador na posição inicial da segunda sequência.

Valor de retorno

Retorna true se todo o elemento da gama de first1 para last1 são iguais às da gama a partir de first2 caso contrário ele retorna falso.

Exceções

Lança exceção se a comparação de elemento (ou predicado) 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 na distância entre o primeiro e o último .

Exemplo

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

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

using namespace std;

int main(void) {
   vector<int> v1 = {1, 2, 3};
   vector<int> v2 = {1, 2, 4, 4, 5};
   bool result;

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

   if (result == false)
      cout << "Vector range is not equal." << endl;

   v2[2] = 3;

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

   if (result == true)
      cout << "Vector range is equal." << endl;

   return 0;
}

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

Vector range is not equal.
Vector range is equal.