| list::erase |
public member function |
iterator erase ( iterator position );
iterator erase ( iterator first, iterator last ); |
|
Erase elements
Removes from the list container either a single element (position) or a range of elements ([first,last)).
This effectively reduces the vector size by the number of elements removed, calling each element's destructor before.
lists are sequence containers specifically designed to be efficient inserting and removing elements in any position, even in the middle of the sequence. Compared to the other base sequence containers (vector and deque), lists are the most efficient container erasing at some position other than the beginning or the end of the sequence, and, unlike in these, all of the previously obtained iterators and references remain valid after the erasing operation and refer to the same elements they were referring before (except, naturally, for those referring to erased elements).
Parameters
All parameters are of member type
iterator, which in
list containers are defined as a
bidirectional iterator type.
- position
- Iterator pointing to a single element to be removed from the list.
- first, last
- Iterators specifying a range within the list container to be removed: [first,last). i.e., the range includes all the elements between first and last, including the element pointed by first but not the one pointed by last.
Return value
A bidirectional iterator pointing to the new location of the element that followed the last element erased by the function call, which is the list
end if the operation erased the last element in the sequence.
Example
// erasing from list
#include <iostream>
#include <list>
using namespace std;
int main ()
{
unsigned int i;
list<unsigned int> mylist;
list<unsigned int>::iterator it1,it2;
// set some values:
for (i=1; i<10; i++) mylist.push_back(i*10);
// 10 20 30 40 50 60 70 80 90
it1 = it2 = mylist.begin(); // ^^
advance (it2,6); // ^ ^
++it1; // ^ ^
it1 = mylist.erase (it1); // 10 30 40 50 60 70 80 90
// ^ ^
it2 = mylist.erase (it2); // 10 30 40 50 60 80 90
// ^ ^
++it1; // ^ ^
--it2; // ^ ^
mylist.erase (it1,it2); // 10 30 60 80 90
// ^
cout << "mylist contains:";
for (it1=mylist.begin(); it1!=mylist.end(); ++it1)
cout << " " << *it1;
cout << endl;
return 0;
}
|
Output:
mylist contains: 10 30 60 80 90
|
Complexity
Linear on the number of elements erased (destructors).
See also
| list::remove | Remove elements with specific value (public member function) |
