命名空间
变体
操作

std::flat_multimap<Key,T,Compare,KeyContainer,MappedContainer>::erase

来自 cppreference.com
 
 
 
 
iterator erase( iterator position );
(1) (自 C++23 起)
iterator erase( const_iterator pos );
(2) (自 C++23 起)
iterator erase( const_iterator first, const_iterator last );
(3) (自 C++23 起)
size_type erase( const Key& key );
(4) (自 C++23 起)
template< class K >
size_type erase( K&& x );
(5) (自 C++23 起)

从容器中删除指定元素。剩余等效元素的顺序将被保留。

1,2) 删除位于 pos 的元素。
3) 删除范围 [firstlast) 中的元素,该范围必须是 *this 中的有效范围。
4) 删除所有键等效于 key 的元素。
5) 删除所有与值 x 进行等效比较的键的元素。只有当限定标识符 Compare::is_transparent 有效并表示一个类型,并且 iteratorconst_iterator 都不能从 K 隐式转换时,此重载才参与重载解析。它允许在不构建 Key 实例的情况下调用此函数。

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

内容

[编辑] 参数

pos - 指向要删除的元素的迭代器
first, last - 要删除的元素范围
key - 要删除的元素的键值
x - 任何可以与表示要删除元素的键透明比较的值

[编辑] 返回值

1-3) 紧随最后一个已删除元素的迭代器。
4) 已删除的元素数量。
5) 已删除的元素数量。

[编辑] 异常

1-3) 不抛出任何异常。
4,5)Compare 对象抛出的任何异常。

[编辑] 复杂度

取决于底层容器。通常为线性。

[编辑] 示例

#include <flat_map>
#include <iostream>
 
int main()
{
    std::flat_multimap<int, std::string> c =
    {
        {1, "one"}, {2, "two"}, {3, "three"},
        {4, "four"}, {5, "five"}, {6, "six"}
    };
 
    // erase all odd numbers from c
    for (auto it = c.begin(); it != c.end();)
    {
        if (it->first % 2 != 0)
            it = c.erase(it);
        else
            ++it;
    }
 
    for (auto& p : c)
        std::cout << p.second << ' ';
    std::cout << '\n';
}

输出

two four six

[编辑] 参见

清除内容
(公有成员函数) [编辑]