Struct equal_to

Um predicado binário que executa a operação de igualdade (operator==) em seus argumentos.

template<class Type = void>
   struct equal_to : public binary_function<Type, Type, bool> 
   {
      bool operator()(
         const Type& Left, 
         const Type& Right
      ) const;
   };

// specialized transparent functor for operator==
template<>
   struct equal_to<void>
   {
      template<class Type1, class Type2>
      auto operator()(Type1&& Left, Type2&& Right) const
         -> decltype(std::forward<Type1>(Left)
            == std::forward<Type2>(Right));
   };

Parâmetros

• Type, Type1, Type2
  Qualquer tipo que ofereça suporte operator== que usa operandos dos tipos especificados ou inferidos.

• Left
  O operando esquerdo de uma operação de igualdade. O modelo unspecialized usa um argumento de referência de lvalue do tipo Type. O modelo especializado aperfeiçoa a transmissão de argumentos de referência de lvalue e de rvalue de tipo inferido Type1.

• Right
  O operando direito de uma operação de igualdade. O modelo unspecialized usa um argumento de referência de lvalue do tipo Type. O modelo especializado aperfeiçoa a transmissão de argumentos de referência de lvalue e de rvalue de tipo inferido Type2.

Valor de retorno

O resultado de Left==Right. O modelo especializado aperfeiçoa a transmissão de resultado, que contém o tipo que é retornado por operator==.

Comentários

Os objetos do tipo Type devem ser igualdade- comparáveis. Isso exige que operator== definida no conjunto de objetos satisfaz as propriedades matemáticas de uma relação de equivalência. Todos os tipos numéricos internos e do ponteiro satisfazem esse requisito.

Exemplo

// functional_equal_to.cpp
// compile with: /EHsc
#include <vector>
#include <functional>
#include <algorithm>
#include <iostream>

using namespace std;

int main( )
{
   vector <double> v1, v2, v3 ( 6 );
   vector <double>::iterator Iter1, Iter2, Iter3;
   
   int i;
   for ( i = 0 ; i <= 5 ; i+=2 )
   {
      v1.push_back( 2.0 *i );
      v1.push_back( 2.0 * i + 1.0 );
   }

   int j;
   for ( j = 0 ; j <= 5 ; j+=2 )
   {
      v2.push_back( - 2.0 * j );
      v2.push_back( 2.0 * j + 1.0 );
   }

   cout << "The vector v1 = ( " ;
   for ( Iter1 = v1.begin( ) ; Iter1 != v1.end( ) ; Iter1++ )
      cout << *Iter1 << " ";
   cout << ")" << endl;

   cout << "The vector v2 = ( " ;
   for ( Iter2 = v2.begin( ) ; Iter2 != v2.end( ) ; Iter2++ )
      cout << *Iter2 << " ";
   cout << ")" << endl;

   // Testing for the element-wise equality between v1 & v2
   transform ( v1.begin( ),  v1.end( ), v2.begin( ), v3.begin ( ), 
      equal_to<double>( ) );

   cout << "The result of the element-wise equal_to comparison\n"
      << "between v1 & v2 is: ( " ;
   for ( Iter3 = v3.begin( ) ; Iter3 != v3.end( ) ; Iter3++ )
      cout << *Iter3 << " ";
   cout << ")" << endl;
}