list::clear


public member function
void clear ( );

Clear content

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

Parameters

none

Return value

none

Example

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
 
// clearing lists
#include <iostream>
#include <list>
using namespace std;

int main ()
{
  list<int> mylist;
  list<int>::iterator it;

  mylist.push_back (100);
  mylist.push_back (200);
  mylist.push_back (300);

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

  mylist.clear();
  mylist.push_back (1101);
  mylist.push_back (2202);

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

  cout << endl;

  return 0;
}


Output:
mylist contains: 100 200 300
mylist contains: 1101 2202


Complexity

Linear on size (destructors).

See also

list::erase Erase elements (public member function)
list::resize Change size (public member function)
list::pop_back Delete last element (public member function)
list::pop_front Delete first element (public member function)
list::remove Remove elements with specific value (public member function)
list::unique Remove duplicate values (member function)
list::empty Test whether container is empty (public member function)