cplusplus.com cplusplus.com
cplusplus.com   C++ : Reference : STL Containers : list : 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
list
comparison operators
list::list
list::~list
member functions:
· list::assign
· list::back
· list::begin
· list::clear
· list::empty
· list::end
· list::erase
· list::front
· list::get_allocator
· list::insert
· list::max_size
· list::merge
· list::operator=
· list::pop_back
· list::pop_front
· list::push_back
· list::push_front
· list::rbegin
· list::remove
· list::remove_if
· list::rend
· list::resize
· list::reverse
· list::size
· list::sort
· list::splice
· list::swap
· list::unique

-

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

// 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)

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