std::inplace_vector<T,N>:: erase

从容器中擦除指定元素。

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

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

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

参数

返回值

指向最后一个被移除元素之后的迭代器。

异常处理

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

复杂度

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

注释

当需要基于谓词擦除容器元素时，通常使用迭代器范围重载配合 std::remove()/std::remove_if() 来最小化剩余（未删除）元素的移动次数——这就是擦除-删除惯用法。 std::erase_if() 可替代擦除-删除惯用法。

示例

#include <inplace_vector>
#include <print>
int main()
{
    std::inplace_vector<int, 10> v{0, 1, 2, 3, 4, 5, 6, 7, 8, 9};
    std::println("{}", v);
    v.erase(v.begin());
    std::println("{}", v);
    v.erase(v.begin() + 2, v.begin() + 5);
    std::println("{}", v);
    // 删除所有偶数
    for (std::inplace_vector<int, 10>::iterator it{v.begin()}; it != v.end();)
        if (*it % 2 == 0)
            it = v.erase(it);
        else
            ++it;
    std::println("{}", v);
}

[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]

参见