The following code example is taken from the book
The C++ Standard Library - A Tutorial and Reference, 2nd Edition
by Nicolai M. Josuttis, Addison Wesley Longman, 2012
Copyright © 2012 by Pearson Education, Inc. and Nicolai M. Josuttis
#include <iostream>
#include <set>
#include <algorithm>
#include <iterator>
using namespace std;
int main()
{
// type of the collection:
// - duplicates allowed
// - elements are integral values
// - descending order
multiset<int,greater<int>> coll1;
// insert elements in random order using different member functions
coll1.insert({4,3,5,1,6,2});
coll1.insert(5);
// print all elements
for (int elem : coll1) {
cout << elem << ' ';
}
cout << endl;
// insert 4 again and process return value
auto ipos = coll1.insert(4);
cout << "4 inserted as element "
<< distance(coll1.begin(),ipos) + 1 << endl;
// assign elements to another multiset with ascending order
multiset<int> coll2(coll1.cbegin(),coll1.cend());
// print all elements of the copy using stream iterators
copy (coll2.cbegin(), coll2.cend(),
ostream_iterator<int>(cout," "));
cout << endl;
// remove all elements up to element with value 3
coll2.erase (coll2.begin(), coll2.find(3));
// remove all elements with value 5
int num;
num = coll2.erase (5);
cout << num << " element(s) removed" << endl;
// print all elements
copy (coll2.cbegin(), coll2.cend(),
ostream_iterator<int>(cout," "));
cout << endl;
}