operator== (multimap)

Tests if the multimap object on the left side of the operator is equal to the multimap object on the right side.

bool operator==( 
   const multimap <Key, Type, Traits, Allocator>& _Left, 
   const multimap <Key, Type, Traits, Allocator>& _Right 
);

Parameters

  • _Left
    An object of type multimap.

  • _Right
    An object of type multimap.

Return Value

true if the multimap on the left side of the operator is equal to the multimap on the right side of the operator; otherwise false.

Remarks

The comparison between multimap objects is based on a pairwise comparison of their elements. Two multimaps are equal if they have the same number of elements and their respective elements have the same values. Otherwise, they are unequal.

Example

// multimap_op_eq.cpp
// compile with: /EHsc
#include <map>
#include <iostream>

int main( )
{
   using namespace std;
   multimap<int, int> m1, m2, m3;
   int i;
   typedef pair<int, int> Int_Pair;

   for (i = 0; i < 3; i++)
   {
      m1.insert(Int_Pair(i, i));
      m2.insert(Int_Pair(i, i*i));
      m3.insert(Int_Pair(i, i));
   }

   if ( m1 == m2 )
      cout << "m1 and m2 are equal" << endl;
   else
      cout << "m1 and m2 are not equal" << endl;

   if ( m1 == m3 )
      cout << "m1 and m3 are equal" << endl;
   else
      cout << "m1 and m3 are not equal" << endl;
}
m1 and m2 are not equal
m1 and m3 are equal

Requirements

Header: <map>

Namespace: std

See Also

Reference

Standard Template Library