std::deque<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 );

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

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

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

Итератор first не обязательно должен быть разрешаемым для доступа, если first == last: удаление пустого диапазона — это пустая операция.

Параметры

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

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

Исключения

Не выбрасывает исключения, если исключение не выбрасывает оператор присваивания T.

Сложность

Линейная: число вызовов деструктора T совпадает с числом удалённых элементов, число вызовов оператора присваивания T не превышает меньшего из числа элементов перед удалёнными элементами и числа элементов после удалённых элементов.

Примечания

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

Пример

#include <deque>
#include <iostream>
 
 
void print_container(const std::deque<int>& c) 
{
    for (int i : c)
        std::cout << i << ' ';
    std::cout << '\n';
}
 
int main()
{
    std::deque<int> c{0, 1, 2, 3, 4, 5, 6, 7, 8, 9};
    print_container(c);
 
    c.erase(c.begin());
    print_container(c);
 
    c.erase(c.begin() + 2, c.begin() + 5);
    print_container(c);
 
    // Erase all even numbers
    for (std::deque<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++.

См. также