std::list<T,Allocator>::erase

iterator erase( iterator pos );

iterator erase( const_iterator pos );

iterator erase( iterator first, iterator last );

iterator erase( const_iterator first, const_iterator last );

Удаляет указанные элементы из контейнера.

Ссылки и итераторы на удалённые элементы становятся недействительными. Остальные ссылки и итераторы не затрагиваются.

Итератор pos должен быть действительным и разыменовываемым. Поэтому итератор end() (который является действительным, но не разыменовываемым) нельзя использовать в качестве значения для pos.

Итератор first не обязан быть разыменовываемым, если first == last: удаление пустого диапазона не приводит к изменениям.

Параметры

Возвращаемое значение

Итератор, следующий за последним удалённым элементом.

Сложность

Примечания

Если элементы контейнера требуется удалить на основании предиката, то вместо обхода контейнера с вызовом унарного erase обычно используют перегрузку с диапазоном итераторов вместе с std::remove()/std::remove_if(), чтобы свести к минимуму количество перемещений оставшихся (не удалённых) элементов, — это идиома erase-remove. std::erase_if() заменяет идиому erase-remove.(начиная с C++20)

Пример

#include <list>
#include <iostream>
#include <iterator>

void print_container(const std::list<int>& c)
{
    for (int i : c)
        std::cout << i << ' ';
    std::cout << '\n';
}

int main()
{
    std::list<int> c{0, 1, 2, 3, 4, 5, 6, 7, 8, 9};
    print_container(c);

    c.erase(c.begin());
    print_container(c);

    std::list<int>::iterator range_begin = c.begin();
    std::list<int>::iterator range_end = c.begin();
    std::advance(range_begin, 2);
    std::advance(range_end, 5);

    c.erase(range_begin, range_end);
    print_container(c);

    // Erase all even numbers
    for (std::list<int>::iterator it = c.begin(); it != c.end();)
    {
        if (*it % 2 == 0)
            it = c.erase(it);
        else
            ++it;
    }
    print_container(c);
}

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

Отчёты об ошибках

Следующие отчёты об ошибках, изменяющие поведение, были применены ретроактивно к ранее опубликованным стандартам C++.

См. также