cplusplus.com cplusplus.com
cplusplus.com   C++ : Reference : STL Containers : multiset : clear
- -
C++
Information
Documentation
Reference
Articles
Sourcecode
Forum
Reference
C Library
IOstream Library
Strings library
STL Containers
STL Algorithms
STL Containers
bitset
deque
list
map
multimap
multiset
priority_queue
queue
set
stack
vector
multiset
comparison operators
multiset::multiset
multiset::~multiset
member functions:
· multiset::begin
· multiset::clear
· multiset::count
· multiset::empty
· multiset::end
· multiset::equal_range
· multiset::erase
· multiset::find
· multiset::get_allocator
· multiset::insert
· multiset::key_comp
· multiset::lower_bound
· multiset::max_size
· multiset::operator=
· multiset::rbegin
· multiset::rend
· multiset::size
· multiset::swap
· multiset::upper_bound
· multiset::value_comp

-

multiset::clear public member function
void clear ( );

Clear content

All the elements in the container are dropped: their destructors are called, and they are removed from the container, leaving it with a size of 0.

Parameters

none

Return value

none

Example

// multiset::clear
#include <iostream>
#include <set>
using namespace std;

int main ()
{
  multiset<int> mymultiset;
  multiset<int>::iterator it;

  mymultiset.insert (11);
  mymultiset.insert (42);
  mymultiset.insert (11);

  cout << "mymultiset contains:";
  for (it=mymultiset.begin(); it!=mymultiset.end(); ++it)
    cout << " " << *it;

  mymultiset.clear();
  mymultiset.insert (200);
  mymultiset.insert (100);

  cout << "\nmymultiset contains:";
  for (it=mymultiset.begin(); it!=mymultiset.end(); ++it)
    cout << " " << *it;

  cout << endl;

  return 0;
}

Output:

mymultiset contains: 11 11 42
myset contains: 100 200

Complexity

Linear in size (destructors).

See also

multiset::erase Erase elements (public member function)
multiset::size Return container size (public member function)
multiset::empty Test whether container is empty (public member function)

© The C++ Resources Network, 2000-2007 - All rights reserved
Spotted an error? - contact us