命名空间
变体
操作

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

来自 cppreference.com
< cpp‎ | 容器‎ | 原地向量
 
 
 
 
constexpr iterator erase( const_iterator pos );
(1) (自 C++26 起)
constexpr iterator erase( const_iterator first, const_iterator last );
(2) (自 C++26 起)

从容器中删除指定的元素。

1) 删除 pos 处的元素。
2) 删除范围 [firstlast) 中的元素。

迭代器(包括 end() 迭代器)以及指向删除点或其后的元素的引用将失效。

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

如果 first == last,则迭代器 first 不需要可解引用:删除空范围是一个无操作。

内容

[编辑] 参数

pos - 指向要删除的元素的迭代器
first, last - 要删除的元素范围

[编辑] 返回值

指向最后一个被删除元素的下一个元素的迭代器。

1) 如果 pos 指向最后一个元素,则返回 end() 迭代器。
2) 如果在删除之前 last == end(),则返回更新后的 end() 迭代器。
如果 [firstlast) 是一个空范围,则返回 last

[编辑] 异常

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

[编辑] 复杂度

线性:调用 T 的析构函数的次数与删除的元素数量相同,调用 T 的赋值运算符的次数等于删除元素后向量中的元素数量。

[编辑] 备注

当需要根据谓词删除容器元素时,而不是迭代容器并调用一元 erase,通常使用迭代器范围重载与 std::remove()/std::remove_if() 来最大程度地减少对剩余(未删除)元素的移动次数,——这是 erase-remove idiom。std::erase_if() 替换了 erase-remove idiom。

[编辑] 示例

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

[编辑] 参见

删除所有满足特定条件的元素
(函数模板) [edit]
清除内容
(公共成员函数) [edit]