operator< (<list>)

Tests if the list object on the left side of the operator is less than the list object on the right side.

bool operator<(
   const list<Type, Allocator>& _Left,
   const list<Type, Allocator>& _Right
);

Parameters

  • _Left
    An object of type list.

  • _Right
    An object of type list.

Return Value

true if the list on the left side of the operator is less than but not equal to the list on the right side of the operator; otherwise false.

Remarks

The comparison between list 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

// list_op_lt.cpp
// compile with: /EHsc
#include <list>
#include <iostream>

int main( ) 
{
   using namespace std; 
   list <int> c1, c2;
   c1.push_back( 1 );
   c1.push_back( 2 );
   c1.push_back( 4 );

   c2.push_back( 1 );
   c2.push_back( 3 );

   if ( c1 < c2 )
      cout << "List c1 is less than list c2." << endl;
   else
      cout << "List c1 is not less than list c2." << endl;
}

Output

List c1 is less than list c2.

Requirements

Header: <list>

Namespace: std

See Also

Concepts

<list> Members

Standard Template Library