std::forward_list::erase_after

Parameters

position

Iterator pointing to an element in the forward_list container. The (first) element removed is the one after this.
Member type const_iterator is a forward iterator type that points to elements.

last

Iterator pointing to the element after the last one to be removed. The range of elements removed is the open interval (position,last), which includes all the elements between position and last, but not position nor last themselves.
Member type const_iterator is a forward iterator type that points to elements.

Return value

Example

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

// erasing from forward_list
#include <iostream>
#include <forward_list>
int main ()
{
  std::forward_list<int> mylist = {10, 20, 30, 40, 50};
                                            // 10 20 30 40 50
  auto it = mylist.begin();                 // ^
  it = mylist.erase_after(it);              // 10 30 40 50
                                            //    ^
  it = mylist.erase_after(it,mylist.end()); // 10 30
                                            //       ^
  std::cout << "mylist contains:";
  for (int& x: mylist) std::cout << ' ' << x;
  std::cout << '\n';
  return 0;
}

mylist contains: 10 30

Complexity

Iterator validity

Data races

Exception safety

See also

forward_list::remove

Remove elements with specific value (public member function)

forward_list::unique

Remove duplicate values (public member function)

forward_list::splice_after

Transfer elements from another forward_list (public member function)

forward_list::insert_after

Insert elements (public member function)

forward_list::pop_front

Delete first element (public member function)