operator== (<iterator>)

Artigo
06/09/2015

Testa se o objeto de iterador à esquerda do operador é igual ao objeto de iterador à direita.

template<class RandomIterator1, class RandomIterator2>
    bool operator==(
        const move_iterator<RandomIterator1>& _Left,
        const move_iterator<RandomIterator2>& _Right
    );
template<class RandomIterator1, class RandomIterator2>
    bool operator==(
        const reverse_iterator<RandomIterator1>& _Left,
        const reverse_iterator<RandomIterator2>& _Right
   );
template<class Type, class CharType, class Traits, class Distance>
   bool operator==(
      const istream_iterator<Type, CharType, Traits, Distance>& _Left,
      const istream_iterator<Type, CharType, Traits, Distance>& _Right
   );
template<class CharType, class Tr>
   bool operator==(
      const istreambuf_iterator<CharType, Traits>& _Left,
      const istreambuf_iterator<CharType, Traits>& _Right
);

Parâmetros

_Left
Um objeto de iterador do tipo.
_Right
Um objeto de iterador do tipo.

Valor de retorno

true se os objetos forem iguais; iterator false se os objetos de iterador não são iguais.

Comentários

Um objeto de iterador é igual a outro se apenas os mesmos elementos em um contêiner. Se o ponto de dois iteradores a diferentes elementos em um contêiner, neles não são iguais.

Os primeiros dois operadores de modelo retornam true apenas se _Left e _Right armazena o mesmo iterador. O terceiro operador de modelo só retornará true se _Left e _Right armazena o mesmo ponteiro de fluxo. O quarto operador de modelo retorna _Left.equal (_Right).

Exemplo

// iterator_op_eq.cpp
// compile with: /EHsc
#include <iterator>
#include <vector>
#include <iostream>

int main( )
{
   using namespace std;
   int i;

   vector<int> vec;
   for ( i = 1 ; i < 6 ; ++i )
   {
      vec.push_back ( 2 * i );
   }
   
   vector <int>::iterator vIter;

   cout << "The vector vec is: ( ";
   for ( vIter = vec.begin( ) ; vIter != vec.end( ); vIter++)
      cout << *vIter << " ";
   cout << ")." << endl;

   // Initializing reverse_iterators to the last element
   vector <int>::reverse_iterator rVPOS1 = vec.rbegin ( ), 
           rVPOS2 = vec.rbegin ( );
   
   cout << "The iterator rVPOS1 initially points to the first "
        << "element\n in the reversed sequence: "
        << *rVPOS1 << "." << endl;

   if ( rVPOS1 == rVPOS2 )
      cout << "The iterators are equal." << endl;
   else
      cout << "The iterators are not equal." << endl;

   rVPOS1++;
   cout << "The iterator rVPOS1 now points to the second "
        << "element\n in the reversed sequence: "
        << *rVPOS1 << "." << endl;

   if ( rVPOS1 == rVPOS2 )
      cout << "The iterators are equal." << endl;
   else
      cout << "The iterators are not equal." << endl;
}

Requisitos

Cabeçalho: <iterator>

Namespace: std

Consulte também

Referência

Biblioteca de Modelos Padrão

Compartilhar via