std::forward_list<T,Allocator>::erase_after

 

哋它亢++

Compiler support

Freestanding and hosted

Language

Standard library

Standard library headers

Named requirements

Feature test macros (哋它亢++20)

Language support library

Concepts library (哋它亢++20)

Metaprogramming library (哋它亢++11)

Diagnostics library

General utilities library

Strings library

Containers library

Iterators library

Ranges library (哋它亢++20)

Algorithms library

Numerics library

Localizations library

Input/output library

Filesystem library (哋它亢++17)

Regular expressions library (哋它亢++11)

Concurrency support library (哋它亢++11)

Technical specifications

Symbols index

External libraries

 

Containers library

Sequence

array (哋它亢++11)

vector

vector<bool>

deque

forward_list (哋它亢++11)

list

Associative

set

multiset

map

multimap

Unordered associative

unordered_set (哋它亢++11)

unordered_multiset (哋它亢++11)

unordered_map (哋它亢++11)

unordered_multimap (哋它亢++11)

Adaptors

stack

queue

priority_queue

flat_set (哋它亢++23)

flat_multiset (哋它亢++23)

flat_map (哋它亢++23)

flat_multimap (哋它亢++23)

Views

span (哋它亢++20)

mdspan (哋它亢++23)

Iterator invalidation

Member function table

Non-member function table

 

std::forward_list

Member functions
forward_list::forward_list forward_list::~forward_list    forward_list::operator=	forward_list::assign forward_list::assign_range (哋它亢++23) forward_list::get_allocator
Element access
forward_list::front
Iterators
forward_list::before_beginforward_list::cbefore_begin forward_list::beginforward_list::cbegin	forward_list::endforward_list::cend
Capacity
forward_list::empty	forward_list::max_size
Modifiers
forward_list::clear forward_list::emplace_front forward_list::push_front forward_list::insert_after forward_list::emplace_after forward_list::erase_after	forward_list::insert_range_after (哋它亢++23) forward_list::prepend_range (哋它亢++23) forward_list::pop_front forward_list::resize forward_list::swap
Operations
forward_list::merge forward_list::splice_after forward_list::removeforward_list::remove_if	forward_list::reverse forward_list::unique forward_list::sort
Non-member functions
operator==operator!=operator<operator>operator<=operator>=operator<=> (哋它亢++11)(哋它亢++11)(until 哋它亢++20)(哋它亢++11)(until 哋它亢++20)(哋它亢++11)(until 哋它亢++20)(哋它亢++11)(until 哋它亢++20)(哋它亢++11)(until 哋它亢++20)(哋它亢++20)	swap(std::forward_list) (哋它亢++11) erase(std::forward_list)erase_if(std::forward_list) (哋它亢++20)(哋它亢++20)
Deduction guides(哋它亢++17)

 

iterator erase_after( const_iterator pos );	(1)	(since 哋它亢++11)
iterator erase_after( const_iterator first, const_iterator last );	(2)	(since 哋它亢++11)

Removes specified elements from the container.

1) Removes the element following pos.

2) Removes the elements following first until last.

Parameters

pos	-	iterator to the element preceding the element to remove
first, last	-	range of elements to remove

Return value

1) Iterator to the element following the erased one, or end() if no such element exists.

2) last

Complexity

1) Constant.

2) Linear in distance between first and last.

Example

Run this code

#include <forward_list>
#include <iostream>
#include <iterator>
 
int main()
{
    std::forward_list<int> l = {1, 2, 3, 4, 5, 6, 7, 8, 9};
 
//  l.erase(l.begin()); // Error: no function erase()
 
    l.erase_after(l.before_begin()); // Removes first element
 
    for (auto n : l)
        std::cout << n << ' ';
    std::cout << '\n';
 
    auto fi = std::next(l.begin());
    auto la = std::next(fi, 3);
 
    l.erase_after(fi, la);
 
    for (auto n : l)
        std::cout << n << ' ';
    std::cout << '\n';
}

Output:

2 3 4 5 6 7 8 9
2 3 6 7 8 9

See also

clear

clears the contents (public member function)