operator< (multimap)

Tests if the multimap object on the left side of the operator is less than 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 strictly less than 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. The less-than relationship between two objects is based on a comparison of the first pair of unequal elements.

Example

// multimap_op_lt.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 = 1 ; i < 3 ; i++ )
   {
      m1.insert ( Int_Pair ( i, i ) );
      m2.insert ( Int_Pair ( i, i * i ) );
      m3.insert ( Int_Pair ( i, i - 1 ) );
   }

   if ( m1 < m2 )
      cout << "The multimap m1 is less than the multimap m2." << endl;
   else
      cout << "The multimap m1 is not less than the multimap m2." << endl;

   if ( m1 < m3 )
      cout << "The multimap m1 is less than the multimap m3." << endl;
   else
      cout << "The multimap m1 is not less than the multimap m3." << endl;
}
The multimap m1 is less than the multimap m2.
The multimap m1 is not less than the multimap m3.

Requirements

Header: <map>

Namespace: std

See Also

Reference

Standard Template Library