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

从容器中擦除指定元素。

迭代器（包括 end() 迭代器）以及指向被擦除位置或之后元素的引用均会失效。

迭代器 pos 必须有效且可解引用。因此 end() 迭代器（虽然有效但不可解引用）不能用作 pos 的值。

当迭代器 first 满足 first == last 时，无需进行解引用操作：擦除空范围属于空操作。

参数

返回值

指向被移除元素之后位置的迭代器。

异常处理

除非 T 的赋值运算符抛出异常，否则不会抛出异常。

复杂度

线性：调用 T 析构函数的次数与被擦除元素数量相同，调用 T 赋值运算符的次数等于擦除元素后向量中剩余元素的数量。

注释

当需要基于谓词擦除容器元素时，通常不采用遍历容器并调用一元 erase 的方式，而是使用迭代器范围重载配合 std::remove()/std::remove_if() 来最小化剩余（未删除）元素的移动次数——这就是擦除-删除惯用法。 std::erase_if() 已取代擦除-删除惯用法。 (C++20 起)

示例

#include <vector>
#include <iostream>
void print_container(const std::vector<int>& c)
{
    for (int i : c)
        std::cout << i << ' ';
    std::cout << '\n';
}
int main()
{
    std::vector<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);
    // 删除所有偶数
    for (std::vector<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++标准。

参见