The following code example is taken from the book
The C++ Standard Library - A Tutorial and Reference
by Nicolai M. Josuttis, Addison-Wesley, 1999
© Copyright Nicolai M. Josuttis 1999
#include "algostuff.hpp"
using namespace std;
int main()
{
list<int> coll;
INSERT_ELEMENTS(coll,1,9);
INSERT_ELEMENTS(coll,1,9);
coll.sort ();
PRINT_ELEMENTS(coll);
// print first and last position 5 could get inserted
pair<list<int>::iterator,list<int>::iterator> range;
range = equal_range (coll.begin(), coll.end(),
5);
cout << "5 could get position "
<< distance(coll.begin(),range.first) + 1
<< " up to "
<< distance(coll.begin(),range.second) + 1
<< " without breaking the sorting" << endl;
}