std::inplace_vector<T,N>::erase
来自 cppreference.cn
< cpp | container | inplace vector
| constexpr iterator erase( const_iterator pos ); |
(1) | (since C++26) |
| constexpr iterator erase( const_iterator first, const_iterator last ); |
(2) | (since C++26) |
从容器擦除指定的元素。
1) 移除位于 pos 的元素。
2) 移除范围
[first, last) 内的元素。迭代器（包含 end() 迭代器）以及指向擦除点或之后元素的引用均会失效。
迭代器 pos 必须有效且可解引用。因此 end() 迭代器（有效但不可解引用）不能用作 pos 的值。
如果 first == last，则迭代器 first 不需要可解引用：擦除空范围是空操作。
目录 |
[编辑] 参数
| pos | - | 要移除的元素的迭代器 |
| first, last | - | 定义要移除的元素范围的迭代器对 |
[编辑] 返回值
在最后移除元素之后的迭代器。
1) 如果 pos 指的是最后一个元素，则返回 end() 迭代器。
2) 如果在移除之前 last == end()，则返回更新后的 end() 迭代器。
如果
[first, last) 是一个空范围，则返回 last。[编辑] 异常
除非 T 的赋值运算符抛出异常，否则不抛出异常。
[编辑] 复杂度
线性：对 T 的析构函数的调用次数与擦除的元素数量相同，T 的赋值运算符的调用次数等于向量中擦除元素后剩余的元素数量。
[编辑] 注解
当需要基于谓词擦除容器元素时，通常使用迭代容器并调用一元 erase，而是将迭代器范围重载与 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); // Erase all even numbers 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]
[编辑] 参见
| 擦除所有满足特定标准的元素 (函数模板) | |
| 清除内容 (公共成员函数) |
